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1. Introduction 


1.1. GENERAL 


The purposes of this manual are to afford the information necessary for programming the SPERRY UNIVAC 
9200/9300 Series Tape/Disc Assembler and a reference handbook for the programmer. The use of the assembler 
coding form and the operational characteristics of the assembler are described in succeeding sections. These 
characteristics are summarized briefly as follows: 


a Mnemonic Operation Code 


A fixed name, suggestive of the nature of the instruction and consisting of 2, 3, or 4 letters, is assigned to each 
instruction. This applies to each variant of the branch instructions as a further aid in writing the program. 





a Symbolic Addressing and Automatic Storage Assignment 


Symbolic labels can be assigned to instructions or groups of data. An instruction then references the labeled 
data by the label rather than the storage address. In many cases, other data required by the instruction (such as 
operand length) can be supplied automatically by the assembler. The assembler also keeps track of all storage 
locations used for a particular program and assigns all incoming instructions and data to specific locations. The 
assembler performs base register and displacement calculations. 


s Flexible Data Representation 


Data may be represented in the assembler in binary, hexadecimal, decimal, or character notation, allowing the 
programmer to choose the most suitable form for each constant. 


2 Relocatable Programs and Program Linking 


Programs are prepared by the assembler in absolute or relocatable form. In absolute form, the program storage 
locations are specified within the program. In relocatable form, the actual storage locations to be eccupied by 
a program need not be specified, but if specified, they may be altered easily before loading. Provisions are 
made for linking together, loading, and running as one program the results of separate assemblies. The machine 
time needed to make changes to one part of a program is reduced by use of this provision. The input of one 
assembly can be divided into separate sections, each of which consists of a group of instructions or data, or 
both, occupying contiguous locations. The relative positions of the various sections can be declared at the time 
the program is linked. The output of the assembler is not in loadable form; it must be linked before loading. 





a Macro Instruction Facility 


The assembler includes a macro instruction facility that reduces the effort required to write patterns of coding 
repeated in one program or common to several programs. One command to the assembler results in the 
inclusion in the object program of many instructions and/or constants, or merely results in establishing one or 
more values for use elsewhere within the program. The flexibility of the facility allows a macro to be written 
so that the generated pattern of coding can vary widely depending upon the parameters supplied with the call. 
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a Program Listing 


A printed listing of source and object codes is one output of the assembler. This listing includes error message 
flags marking any errors detected by the assembler. Source-code errors do not cause the assembly process to 
halt; the assembler continues to process the remainder of the source code, performing its usual error checks, 
minimizing the number of assemblies required to produce error-free code. 


A computer with a tape or disc subsystem can handle data faster than a comparable card-oriented system. The 
SPERRY UNIVAC 9200/9300 Series Tape/Disc Assembler relies heavily on the larger storage and file-handling 
capabilities of the tape or disc subsystem to perform many processing operations normally difficult to perform with 
cards only. A built-in macro instruction facility is one of the features of the assembler. Another feature is the linker 
program that provides.a method of combining several separately assembled modules into one executable program. 


1.2. DATA FORMATS 

The basic unit of data in the SPERRY UNIVAC 9000 Series is an 8-bit byte to which a parity bit is added when the 
byte is stored in main storage. A byte may represent a character or a number. Main storage locations are numbered 
consecutively. Each address specifies on byte of information. The address of a group of bytes is the address of the 
leftmost byte of the group. The bits in a byte also are numbered from left to right, starting with zero. Each of the 


formats is illustrated in Table 1—1. 


Table 1—1. Data Formats 


Q——__—_—_—-7 





Half-word data formats consist of two consecutive bytes. 


narrword —_[fofb]/b}bjofe}o] |e] fol a 
3 —_——————_- 


“15 


0———_———_7 


Full-word data formats consist of four consecutive bytes. 


Funrword ——[o}o] bb] oo] of] |b] |e] of] off ob] o fo] ole] ole] fo] o/b] lulo 
3-——— 


18: 16:23:24 Sl 





eco erea aeeeoat A 


Variable data formats consist of a variable number of consecutive bytes. 





Variable 
Den SECCCCC Dee CCCCCOUG 


Format 


= =F —_————7 


First byte Last byte 


It is possible to store any one of 256 different bit combinations in the byte. Data can be represented in various 
forms to the programmer; however, certain restrictions are imposed if the data is to be printed or processed 
arithmetically. The contents of a byte can be considered a binary number, a decimal number, an alphabetic or 
symbolic character, or logical information. A field used to represent a binary number uses all of the bit positions 
(except the sign bit) to contain the value; however, each byte in a field representing a decimal number, 
alphabetic character, or symbol is considered to be divided into zone and digit portions. The zone portion is the 
most significant four bits; the digit portion is the least significant four bits. 


ZONE DIGIT 


et a 


b,b b 
3 7 
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1.2.1. Binary Number Representation 





The binary arithmetic operand is a 16-bit binary number. The bits of the operand are stored in adjacent locations. 
These two consecutive bytes constitute a half word when the address of the more significant byte is an integral 
multiple of two. Such an address is a half-word boundary. 





Positive binary numbers are represented in conventional binary notation with a O bit in the most significant bit te 
position; this is the sign bit for a binary number. 





sign 2 bytes 
er 
1 7) 8 15 





Negative numbers are represented as the twos complement of the number with a 1 bit in the sign position. For 
instance, the representation of the negative number —19,761 would be determined as follows: 








The binary equivalent of 19,761 is: 0100110100110001 
The ones complement is: 1011001011001110 
The twos complement formed by adding 1 is: 1011001011001111 


With the sign bit set to 1 for a negative number, the two bytes appear as: 





The largest possible values that may be represented in the binary format are +32,767 and —32,768. 





1.2.2. Hexadecimal Representation 


Hexadecimal digits are base 16 numbers with values O through F(15). A hexadecimal digit is used to denote a 
particular bit pattern in the zone or digit portion of a byte representing a decimal number, or alphabetic or symbolic 
character. (Hexadecimal digits also are used for constant definition as described in Section 2.) The hexadecimal 
digits and their binary values are: 








Hexadecimal Hexadecimal 
Digit Digit 


™M7O0OWPOM 


0 
1 
2 
3 
4 
5 
6 
7 
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1.2.3. Decimal Number Representation 
Decimal numbers are represented in unpacked form (one digit per byte) or packed form (two digits per byte). 


In unpacked form, the byte is divided into zone and digit portions. The zone portion usually contains a hexadecimal 
F bit configuration (1111), which is ignored except in the least significant byte; the zone portion of the least 
significant byte is interpreted as the sign of the number. 


t 1 
ZONE | DIGIT | ZONE | DIGIT | ZONE ! DIGIT | SIGN | DIGIT 


In packed form, digits are contained in both halves of a byte except the least significant half byte of the field, which 
is interpreted as the sign of the number. 


i] H 1 
DIGIT | DIGIT } DIGIT } DIGIT | DIGIT } DIGIT | DIGIT | SIGN 
1 


The interpretation of the contents of the sign position is: 


Hexadecimal 
Character 


7 
io) 


0000—1000 Positive 

1001 Negative 

1010 Positive* 

1011 Negative” 

1100 Positive (EBCDIC mode)** 
1101 Negative (EBCDIC mode)** 
1110 Positive (EBCDIC mode) 
1111 Positive (EBCDIC mode)*** 


9 
A 
B 
C 
D 
E 
F 





* Generated when processor is in the ASCI! mode. 
** Automatically generated in the central processor for decimal operations. 
*** Automatically generated in the central processor for a zone fill during unpack instruction. 


1.2.4. Character Representation 


An alphabetic or other symbolic character representation is contained in the full eight bits of a byte. A character 
field is considered as not containing a sign. This type of field is represented: 7 


i 7 
ZONE } DIGIT | ZONE } DIGIT | ZONE DIGIT ZONE ! DIGIT 
( { 
tt til al 


atl 
CHARACTER CHARACTER CHARACTER CHARACTER 
CHARACTER REPRESENTATION BINARY VALUE (EBCDIC CODE) 
C’D’ 11000100 
-C’GROSS’ 1100011111011001110101101110001011100010 


c’9’ 11111001 
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1.2.5. Logical Information 





Logical information consists of alphabetic or numeric character codes. This information is used in operations such as 
compare, translate, edit, bit setting, and bit testing. Logical information is processed as fixed- or variable-length data 
and from left to right, one byte at a time. Variable-length logical information consists of up to 256 bytes. 





1.3. STATEMENT CONVENTIONS 


The conventions used to illustrate statements in the manual are: 








a Capital letters and punctuation marks (except braces, brackets, and ellipses) are information that must be 
coded exactly as shown. 


a Lowercase letters and terms represent information that must be supplied by the programmer. 


s Information contained within braces represents necessary entries, one of which must be chosen. 


a Information contained within brackets represents optional entries that (depending on program requirements) 
are included or omitted. Braces within brackets signify that one of the entries must be chosen if that operand 
is included. 





a An ellipsis indicates the presence of a variable number of entries. 


a Commas are required after each parameter except after the last parameter specified. When a positional 
parameter is omitted from a series of parameters, the comma must be retained to indicate the omission. : 
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2. Assembler Language 


2.1. CHARACTER SET 


The character set used in writing statements in the SPERRY UNIVAC 9200/9300 Series Tape/Disc Assembler 
language consists of: 


Letters A,B,C,...,2Z 
Digits 0,1,2,...,9 
Special symbols /=&.*+—,()' blank 


The correspondence between graphics and internal code assumed by the assembler is shown in Appendix B. 


2.2. STATEMENT FORMAT 


Statements in the assembler language are written on a standard coding form, shown in Figure 2—1. Information for 
the assembler and comments are written in columns 1 through 71. Columns 73 through 80 may contain program 
identification and sequencing information. The information in columns 1 through 72 consists of the following fields. 


2.2.1. Label Field 

The label field begins in column 1 and is terminated by a blank column. There may be no embedded blanks. !t may 
be a blank field or contain a symbol of undefined value. More detailed information about symbols is contained in 
2.3.4, 

2.2.2. Operation Field . 

The operation field begins with the first nonblank following the label field and is terminated by a blank. It contains 
the name of an assembler directive, the mnemonic operation code for a machine instruction, or the name of a macro 
instruction. 

2.2.3. Operand Field 

The operand field begins with the first nonblank following the operation field and is terminated by a blank not 


contained in a character representation. This field contains information that defines the operands of a machine 
instruction or supplies the specifications required with an assembler directive. 


ASSEMBLER CODING FORM 


PROGRAMMER 





COMMENTS 





UNIVAC 


SERIES 
PAGE___ OF___.. PAGES 


ei a Pe ed. 


FAs ns COC 








poutiiroa 




















pe Sy i 
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Figure 2—1, Assembler Coding Form 
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2.2.4. Comments Field and Comments Line 


The comments field begins with the column following the blank terminating the operand field and ends at column 
71. It may contain any combination of characters including blanks. it is not processed by the assembler other than 
including it on the assembly listing. It may contain remarks to clarify the purpose or operation of the associated 
coding. A line may consist entirely of comments from columns 2 through 80 if column 1 contains an asterisk. If it is 
desired to write comments on a fine containing a blank operand field, a comma, followed by a space should be 
placed in the operand field to denote its termination. !f this is not done, the first portion of the comments field will 
be treated as part of the operand field. 


Although the assembler language is free form, it is recommended that source code statements be written with the 
first character of the operation code in column 10 and the first character of the operand field in column 16. 
Tabulating the statements in this fashion creates a program listing neater in appearance and easier to read. The 
standard coding form is ruled to conform to this convention. Thus, although the statements on lines 3 and 4 of 
Figure 2—2 are equivalent to the assembler, the form of line 4 is preferred to that of line 3. 


LABEL A SEPRATION OD. OPERAND A 


:CIOIM|ME.N,T] JL IN EL pha pa er trp typi ti 


L PeGin der esta eae ee Eee 
THE, (OPERATION, (|C,0,0,E, [t,S; LH) , yy dy 


G3 
learnt hae AEE 


Figure 2-2. Example of Source Code Statements 

















2.2.5. Continuation Line 


If necessary, a statement may occupy more than one line of the coding form. In this case, a nonblank character is 
placed in column 72 of the first line of the statement, and the statement is continued, beginning with column 16 of 
the succeeding line of the form. Columns 1 through 15 of the second line must be blank. The statement can be 
continued on a third line by placing a nonblank character in column 72 of the second line and continuing the 
statement in column 16 of the following line. Column 72 must be blank in the last (or only) tine of each statement. 


If the operand field of a line is terminated, prior to column 71, by a comma followed by a space, and a nonblank 
character appears in column 72 of the line, the operand field is continued in column 16 of the succeeding line. 
Comments are written after the space terminating the portion of the operand field on the first line. 


2.3. EXPRESSIONS, TERMS, AND OPERATORS 


The operand field of a statement in the assembler language ordinarily consists of one or more expressions. 
Expressions are separated by a comma or parenthesis. Examples of the basic operand formats for instructions are 
shown in Table 3—8. In this table, each letter represents an expression. An expression may be a single term or a 
number of terms connected by operators. The permissible operators are a plus sign (+) representing addition, a minus 
sign (—) representing subtraction, an asterisk (*) representing multiplication, and a slash (/) representing division. A 
leading minus sign also is allowed to produce the negative of the first term. A term may be: 
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a a decimal, hexadecimal, or character representation of an actual value; 

a a location counter reference; 

a a symbo!; 

s a reference to the length attribute of a symbol or of an EXTRN label (with a length attribute of 1); or 


a a literal. 


2.3.1. Representations of Actual Value 
A value may be: 


a a value represented directly by a string of up to five digits, forming a binary number from 0 through 65,535, 
which is converted to a binary value occupying one or two bytes depending on the type of field for which it is 
intended; 


a a value represented by a string of hexadecimal digits identified by a preceding X’ and a following ’ 
(apostrophe), each digit occupying half a byte; or 


s a value represented by a string of characters identified by a preceding C’ and a following ' (apostrophe). 


For additional information concerning value representations, see 1.2. 


2.3.2. Location Counter 


An indication of the next storage location available for assignment is maintained as a counter, called the location 
counter. After the assembler processes an instruction or constant, it adds the length of the processed instruction or 
constant to the location counter. 


The address of each instruction or address constant must be a multiple of two. Such an address is said to fall on a 
half-word boundary. If the value of the location counter is not a multiple of two when assembling such a constant or 
an instruction, a 1 is added to the location counter before assigning an address to the current line. Storage locations 
reserved by this process receive binary 0’s when the program is loaded. 


The current value of the location counter is available for reference in the assembler language and is represented by 
the single special character * (asterisk). If written in a constant representation or in an instruction operand 
expression, this symbol is replaced by the storage address of the leftmost byte allocated to that instruction or 
constant. Thus the following instruction represents a one-instruction loop. P 








A OPERATION A OPERAND A 
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2.3.3. Relative Addressing 


An instruction may address data in its immediate vicinity in the storage in terms of its own storage address. This is a 
form of addressing achieved by an expression of the form *+n or *—n where n is the difference in storage addresses 
of the referring instruction and the instruction or constant being accessed. Relative addressing always is in terms of 
bytes, not words or instructions. For example, in the coding 











LABEL A OPERATION A OPERAND A 
1 10 16 
: Paerareni H Eee eee ere ease neee 
Bic, Meet pt 
A|H 1,5,,,T,W JO Ly I pep et | 


ao fF WN 


PeORereT i heeee tira: 
Peewee Bee 


the address *+12 in line 2 is the address of the instruction in line 5 and the address *—-12 in line 4 is the address of 
the instruction in line 1 because each of the first four instructions is four bytes long. 


Storage addressing is described in 2.5. 


2.3.4. Symbols 


A symbol is a group of as many as eight alphanumeric characters. The first, or leftmost, must be alphabetic. Special 
characters or blanks may not be contained within a symbol. The following are examples of valid symbols: 


A LOSS 
A72Z PROFIT 
CAT GRSVALUE 


The following are not valid symbols for the reasons stated: 
GROSSVALUE more than eight characters 
NPA embedded blank 
SR)N special character 


A symbol may be assigned any value from 0 through 65,535. It is assigned a value, or defined, when it appears in the 
label field of any source-code statement other than a comment. A symbol appearing in the label field of an EQU or 
ORG directive is assigned the value of the expression in the operand field. In all other cases, the value assigned is the 
current value of the location counter after any necessary adjustment to a half-word boundary. The value is assigned 
to the current label before the location counter is incremented for the next instruction, constant, or storage 
definition. Thus, if a symbol appears in the label field of a statement defining an instruction, constant, or storage 
area, the symbol is assigned a value equal to the storage area address of the first byte of that instruction, constant, or 
storage area. 
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2.3.5. Relocatable and Absolute Expressions 


A single term may be absolute or relocatable. Decimal, character, and hexadecimal representations are absolute 
terms. In general, a term is absolute unless the expression consists of: 


8 a location counter reference within a section of relocatable coding; 

a a symbol defined by its appearance in the label field of a section of relocatable coding; 

= an absolute expression plus a relocatable term; or 

a an expression that can be rendered or reduced to an absolute expression plus a relocatable term. 

In addition to these relocatable expressions, a negatively relocatable expression is possible. Such an expression 


consists of an absolute expression minus a relocatable expression, or an expression that may be reordered to that 
form. 


2.3.6. Length Attribute 


A length attribute is associated with the operation of most instructions in the repertoire of machine instructions. 
This length determines the number of bytes to be compared, moved, translated, displayed, or manipulated logically 
or arithmetically. In the cases of RX and SI format instructions (3.2.1), the operation is performed on fixed-length 
data and no length specification is needed. For SS1 and SS2 formats, some length specification must be made in the 
operands to control the amount of data affected by the instruction. If a length is not specified in the operands of 
$S1 and SS2 format instructions, the assembler supplies a length in accordance with the following principles. 


A symbol! defined in the label field of a source-code line representing an instruction, constant, or storage allocation is 


assigned the fength associated with the instruction, constant, or storage area involved. 


A OPERATION A OPERAND A 

10 16 

[Iuvic. | [rac,, vor 

fom nas “FOUR posts casa 


leu 14 weed | 





In the preceding example, AVR is six bytes long because an MVC is a 6-byte instruction, VOR is four bytes because 
the constant occupies four bytes, and TAG is 14 bytes because the storage area is defined as such. The instruction 
labeled AVR moves 14 bytes of data because the implied length of TAG is 14. 

The length attribute of an expression is a function of the leading term. If the first term is an absolute value, a length 
attribute of one byte is assigned. If the first term is a symbol, the length of the symbol is assigned to the expression. 
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In the preceding example, the expression 16+TAG is assigned a length of one byte because the leading term is an 
absolute value, and the expression RTF+16 is assigned a length of six bytes, which is the length of the term RTF. 


When a location counter reference appears as the first term of an expression, the expression is assigned a length 


attribute equal to the length of the instruction or, if the reference to the location counter appears in an EQU 
statement, the length attribute is one byte. 


LABEL A eal OPERAND A 


peRRTea bSPaa a9 11.21 ABC 


prc, 1s. | levau, . | } een ecunccner 


In the preceding example, the expression *+12 is assigned a length of six bytes because MVC is a 6-byte instruction, 
and DFG is assigned a length of one byte because the location counter reference appears in a EQU statement. 


The length attribute of an expression may be referenced in assembler coding by the label with the symbol L’ 
preceding it: 


L’ DFG 


is a reference to the length of the expression DFG. 





In the foregoing example, the move character instruction affects 10 bytes because the length attribute reference was 
to SOME, which was defined as 10 bytes long. The unpack instruction affects six bytes because the length attribute 
reference was to INTR, which appeared in the label field of an MVC instruction, a 6-byte instruction. 


If no length is specified in an operand that uses the base register and displacement notation, the length attribute 
assigned to the operand by the assembler is one byte. 





. 


In the first line of the example, the length attributed to each operand is 16 bytes, as specified. In the second line, the ;| 
assembler assigns a length of one byte to each operand. 











7508 Rev. 3 UNIVAC 9200/9200 11/9300/9300 Il SYSTEMS 


UP-NUMBER PAGE REVISION 





2.3.7. Evaluation of Expressions and Hierarchy of Operators 

The standard mathematical rules of precedence are applied in evaluating expressions; that is, multiplications and 
divisions are performed before additions and subtractions. Operations of the same precedence are performed from 
left to right. Parentheses may be used to group terms, overriding the natural precedence of the operators. 


The following rules must be observed in writing expressions: 


a Two operators may not appear in succession. Write 


A*(—B) 
but not 
A*-B 


a A relocatable expression, an expression involving an external reference (4.5.2), or a negative value, may not 
enter a division. Such a term may be a factor in a multiplication only if the other factor has a value of 0 or 1. 


2.4. DATA STORAGE AND CONSTANT FORMATS 


The formats for data storage and constant definitions consist of a label field and operation field plus four subfields 
in the operand field: duplication factor, type length factor, and constant. 


Any symbol, as previously defined (2.3.4), may be used in the label field; this use of a symbol is optional. 

The operation code is DC for defining constants and DS for defining storage. In either case, the area is assigned the 
address of the leftmost byte, and the length associated with the data is available to the assembler each time the area 
is referenced. 


2.4.1. Define Constant Statements 


The DC statement specifies data that is to be used as stored constants. These constants are produced in object code 
along with the program instructions. The format of the DC statement is: 






A OPERATIONA OPERAND 





[ symbol ] fd] t [Ln] ‘ec’ 
where: 

d a 
Is the optional duplication factor subfield. 

t 
Is the type subfield. 

Ln 
is the optional length factor subfield. 

‘c’ 


ts the constant subfield. 





7508 Rev. 3 
UP-NUMBER 













UNIVAC 9200/9200 11/9300/9300 Il SYSTEMS 






PAGE REVISION 


2.4.2. Define Storage Statements 


The DS statement specifies a storage area to be reserved by the assembler. The format of the DS statement is: 





A OPERATIONA OPERAND 






[ symbol ] ({d] t {Lal [‘c’] 
where: 
d 
Is the optional duplication factor subfield. 
t 
Is the type subfield. 
Ln 
Is the optional length factor subfield. 
‘c’ 


Is the optional constant subfield. 
The subfields are explained in 2.4.4; however, the following modifications for a DS statement should be noted: 
a A constant may be specified in the appropriate subfield of a DS statement, but the constant is not assembled. 
In H, Y, and S types, the constant is ignored, and in the other types it serves only as a determination of the 
size of the area defined. 


a Storage areas defined by DS statements are not cleared of their contents upon loading. 


a Grouping of all DS statements in a program is a good programming practice. 


2.4.3. Literals 


A constant may be defined explicitly by writing a define constant (DC) assembler directive, or more directly by 
writing a literal. A literal is written by entering an equal sign (=) in the appropriate portion of the operand field, 
followed immediately by the description of the constant exactly as it would have appeared in the operand field of a 
DC directive. The appearance of a literal in a source statement causes the assembler to: 


2 include the constant in the program the assembler is producing; 

a assign an address to the constant; and 

a insert the address of the constant in the appropriate portion of the instruction being assembled. 

Constants derived from literals are collected into a pool by the assembler. In the absence of other directions to the 
assembler (4.3.4), this pool is assigned addresses starting at the end of the first control section. Duplicate constants 


are eliminated from the literal pool on the basis of value, not of form. This is not true for type Y or H constants. 
Type Y or H constants, which appear to duplicate others, are eliminated only if the forms are identical. 


PAGE 


2-9 
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An example of the use of a literal is: 


OPERAND 





The following rules must be observed in the use of literals: 


A literal may appear only as the single term defining a storage address operand of an instruction. 


A literal may not appear in an address field defining the receiving address of an instruction that modifies 
storage. 


A source-code line can incorporate no more than one literal. 
Reference to the location counter may not be made in a literal. 
Literals may not be used for type S constants. 


A duplication factor of zero is not permitted. 


2.4.4. Operand Subfields 


The operand field of the DC and DS statements is divided into duplication factor, type, length factor, and constant 
subfields, which describe or identify the data or storage area to be generated. 


The subfields must be specified in the stated order with the duplication factor first and the constant last. Some 
subfields may be omitted; however, the type subfield always must be present. 


The following is a valid example of a typical DC statement with the subfields identified: 










duplication factor 
type 
length factor 


constant 
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2.4.4.1. Duplication Factor Subfield 


The duplication factor indicates to the assembler the number of identical constants to be generated. If no 
duplication factor is specified, the assembler assumes a factor of one. A duplication factor of zero does not generate 
a constant or storage area, but advances the location counter for proper boundary adjustment if no length is 
specified and assigns the location counter value to the symbol in the label field. 


2.4.4.2. Type Subfield 


The type subfield indicates to the assembler the type of constant or storage area to be generated. The types of 
constants and their characteristics are listed in Table 2—1. For further descriptions of the types, see 2.4.6. 


Table 2—1. Constant Characteristics 


Constant Explicit implicit Truncation Value 
Type Length Length or Padding Padded 
Variable On right Blanks Character 
1— 256 side (EBCDIC) 
Variable On left eco Hexadecimal 
1 — 256 side digits 
Variable On left Hexadecimal Packed 
1-16 side ie) decimal 
Zz Variable On left EBCDIC Unpacked 
1—16 side Oo decimal 
Variable On left Hexadecimal Half word* Binary 
1-2 side 0 
Variable On left alec Half word* Binary 
1—2 side address 
Half word* Base and 
displacement 


*Half-word alignment takes place only if implicit lengths are used. 



















2.4.4.3. Length Factor Subfield 


The length factor subfield designates the number of bytes to be used in generating the data or storage area. The 
length factor must follow the character ‘L’ and may be any unsigned decimal within the length limitations of the 
statement type. The maximum length of any DC statement is 256 bytes, but each type is limited (Table 2—1). The 
maximum does not apply to DS statements of the C or X type, where the size of main storage associated with the 
processor is the critical factor. 


If no length factor is specified, the size of the generated area is a function of the constant subfield in C, X, P, and Z 
type statements, and is two bytes for H, Y, and S types (Table 2—1). If the supplied length is less than or more than 
that needed to express the constant specified in its subfield, truncation or padding occurs as specified in Table 2—1. 
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Boundary adjustments are performed only on constants with no supplied length factor. 


LABEL A OPERATION A OPERAND A 


10 16 
§.(,3,2,0/(,1,2,) |) 


fem Pie 
| c Ce 2 A et Pt Pd 
euxg. i | [pic 

| [ic 


—_ 








9 |\0 |9 


| ot 
ic, 5. | dxwts2." Fie, 1.410," 
Dic, | ley," AL B,C," 


Each of the foregoing lines of coding produces the following in binary notation: 


oO 


1100 0001 0100 0000 


Each line produces the same constant because of the modification performed by the length specification on the 
constant originally specified in the coding. In EX1, the address constant is assigned a length of two bytes and 
translated into binary notation; the base register number occupies the first four bits. In EX2, a character 
representation two bytes long is specified. To fill the required length, a blank is padded on the right of the constant. 
The hexadecimal constant, EX3, is too long to fit into the specified length of two bytes. The first four bits are 
truncated. EX4 specifies a character constant too long for the length specified; three bytes are truncated on the 
right. 


2.4.4.4. Constant Subfield 


The constant subfield specifies the value, subject to modification by the length subfield, of the constant to be 
generated. The values for the constants are represented in different ways. (See 2.4.6 for the description of the 
values.) A data value representation is specified by enclosing it in apostrophes, and an address value representation is 
specified by enclosing it in parentheses. 


Data constant Address constant 


‘constant’ (constant) 


2.4.5. Alignment 


All. machine instructions must be aligned on half-word boundaries such that the address of the first byte of the 
instruction must be divisible by 2. Constants, however, can be aligned on a half-word, or no boundary at all. The 
kind of alignment, when necessary, for data or storage definition statements if no length factor is stated is shown in 
Table 2—1. When a length factor is specified by the programmer, no alignment is provided. A duplication factor of 
zero in DC and DS statements does not generate a constant or storage area, but, for some types of constants, it 
forces a boundary alignment if no length factor is coded. This method affords a convenient means of obtaining a 
boundary alignment before generating a constant not automatically aligned by the assembler. Any bytes skipped to 
align constants are zero filled; however, bytes skipped to align storage areas are not zero filled. 
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2.4.6. Data Constant Types 


Data constants are absolute values generated by the assembler and require no modification upon loading. Of the five 
types of data constants, four do not require boundary alignment; that is, the first byte of these constants can be 
assembled at any storage address. These constants are discussed in 2.4.6.1 through 2.4.6.4; the one data-constant 
type requiring boundary adjustment is discussed in 2.4.6.5. 


Each type of constant is described and examples of its use are shown in typical DC statements. 


2.4.6.1. Character Constants 


A character constant is specified by the character C in the type subfield and up to 256 characters enclosed by 
apostrophes in the constant subfield. Any of the 256 valid card punch combinations can be used. Only 63 characters 
of the 256 valid characters are printable. Each character is stored in one byte using the 8-bit character code. If no 
length factor is specified, the length in bytes of the constant equals the number of characters specified. If the length 
factor is present, the character specification is truncated, or filled with blanks, to the right of the last character and 
to the length specified. 


Two consecutive apostrophes or two consecutive ampersands are necessary to generate the character code for one 
apostrophe or one ampersand within the constant. A single apostrophe in the character representation terminates the 
constant. 


Examples: 


LABEL OPERATION OPERAND A 


(e) 
r 
n 
> 





ee ee _> 
an 


W iw 








ee ae oe ee = 


2 

3 

4 pic C6,1,0,7) EMPL; DIV 1,1, 

5 DiC C,b,1, 2)’ 7 

6 C,°,5,0,6|3," wee 
r HEAD, ING," 

8 SEIN eine 
9 


C,.L,6,°11,2,3,4,5)° 


9 
n 
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1. Two-byte constant containing: 


2. One-byte constant containing: 


Ea 


=] 


3. Two-byte constant containing: 


4. —_ Ten-byte constant containing: 


ERDEREORoe 


5. Twelve-byte constant containing blanks: 


eae 


6. Four-byte constant containing: 


5 |o Jo] 3 | 


7. Seven-byte constant containing: 


BYE /AlOUT TSS 


8. Twelve-byte constant containing: 
ERE EN CREU EIEN CUES EREREA 


9. Eighteen-byte constant containing: 


= 








tfa{stats] |ijatsfays| |ajatsjats] 


2.4.6.2. Hexadecimal Constants 

A hexadecimal constant is specified by the character X in the type subfield and up to 256 hexadecimal digits 
enclosed by apostrophes in the constant subfield. Two hexadecimal digits are assembled into one byte. If an odd 
number of digits is specified, the first, or leftmost, byte of the constant contains a hexadecimal O in the four 
leftmost bits and the first digit in the four rightmost bits. If no length factor is specified, the length, in bytes, of the 
constant is half the sum of the number of digits or 0’s specified. If a length factor is present, the decimal 
specification is truncated, or filled with hexadecimal 0’s if necessary, on the leftmost end to the length specified. 
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eo Examples: 
\Y 


OPERATION A OPERAND A 
10 16 


nic, wt Axe A,B,C} 1,2,3,D," 


Xibi4s’ FLIP’ 


X,b,2,' ,112,3,4,5," 


= 


Three-byte constant containing: 


00000000 | 00000000 | 00000001 


Three-byte constant containing: 


0000000 1 {00100011 | 01000101 


Four-byte constant containing: 


00001010 | 10111100 | 00010010 | 00111101 


Four-byte constant containing: 


00000000 | 00000000 | 00001111 | 11111111 


Three-byte constant containing: 


Four-byte constant containing: 


00000000 | 00000000 | 00000000 | 00001010 . 


Two-byte constant containing: 


00100011 | 01000101 


N 


( : 


> 





a 


> 


> 
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2.4.6.3. Packed Decimal Constants eo 
Nad 
A packed decimal constant is specified by the character P in the type subfield and decimal digits enclosed by 
apostrophes in the constant subfield. A leading sign (+ or —) can be coded within the apostrophes. The digits are 
packed two digits per byte; therefore, each decimal digit requires four bits. in the absence of a sign, a positive sign is 
assumed. A plus sign is represented by a hexadecimal C and a minus sign is represented by a hexadecimal D. A 
decimal point can be included in the constant subfield, but is ignored by the assembler. 
If no length factor is specified, the length of the constant is the required number of bytes needed to contain the 
constant, a sign, and a possible addition of zero bits. When an even number of packed decimal digits is specified, the 
leftmost digit is unpaired because the rightmost digit is paired with the sign. In this case, the most significant four 
bits of the leftmost byte contain a hexadecimal 0 and the most significant four bits of the least significant 
(rightmost) byte contain the first (rightmost) digit. The least significant four bits of the rightmost byte always 
contain the sign of the constant. 
If a length factor is present, the decimal specification is truncated, or filled with hexadecimal O’s if necessary, on the 
leftmost end to the length specified. 
Examples: 
LABEL A OPERATION A OPERAND A 
10 16 
Wot | pen ss | fev ae 
pti} id Pi 8,17 8) pikes ve 
3 Hoes. s | enya 214,746," is ae ee ha ae 
peer ee) i isemee Aero ae . 
soot | di | (satis. n 
1. Two-byte constant containing: 
446/8i1C 
2. Three-byte constant, containing: 
ep) 
3 Two-byte constant, with most significant digit truncated, containing: 
ac 
4 Three-byte constant containing: 
t 7 
offs ye | 1) 
5. Six-byte constant containing: 
7 T 2S 
BO ESEFCIBTAEICIET a 
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2.4.6.4. Zoned Decimal Constants 


A zoned (unpacked) decimal constant is specified by the character Z in the type subfield and decimal digits enclosed 
by apostrophes in the constant subfield. A plus or minus sign can be coded within the apostrophes; but if none is 
present, a positive sign is assumed. The digits are assembled, one to a byte, with a hexadecimal F in the most 
significant four bits of all but the least significant byte. The most significant four bits of the least significant byte | 
contain the sign. If no length factor is specified, the length in bytes of the constant is the number of decimal digits in | 
the constant subfield. If a length factor is present, the decimal specification is truncated, or filled with zoned ; 
decimal 0's if necessary, on the leftmost end to the length specified. The rightmost byte always contains the sign and 
the rightmost digit specified. A plus sign is represented by a hexadecimal C and a minus sign is represented by a 
hexadecimal D. A decimal point may be included in the constant subfield, but is ignored by the assembler. | 








Examples: 





OPERAND 














1. Five-byte constant containing: 





BYTE | 


Sige ae te es ee 


EBCDIC B (G sign and digit) 
character 








i ee ce il ei ade Re la 


2. Six-byte constant containing: 











BYTE | 

1 
Peneoea Beogoooogeo0 
EBCDIC M (-sign and digit) 
character 





2.4.6.5. , Half-word Constants 


A half-word constant is specified by the character H in the type subfield and up to five significant decimal digits | 
enclosed by apostrophes in the constant subfield. A plus or minus sign can be included within the apostrophes. If no { 
length factor is specified, the constant has an implied length of two bytes and must not contain a value greater than i 
+32,767 or less than —32,768. If the length factor is present, the decimal value specification is truncated, or filled i 
with binary O's if necessary, on the leftmost end to the length specified. The value specified in the constant subfield 
may be an integer, a fraction, or a mixed number; however, the fractional portion of the mixed number is lost and 
the decimal value is converted into a binary format for storage. 





! 
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Examples: 


A OPERATION A OPERAND 
16 





1. Two-byte constant half-word aligned containing: 


2. One-byte constant not half-word aligned containing: 


2.4.7. Address Constant Types 


Address constants generate either addresses reflecting the storage locations of the program or values based on these 
addresses. Address constants often are used to load general registers or reference external addresses. The location 
counter is adjusted for each constant and any duplication factor used. 


2.4.7.1. Half-word Address Constants 


A half-word address constant is written by specifying the character Y in the type subfield and an expression enclosed 
by parentheses in the constant subfield. The expression may be either absolute or relocatable. 


If no length factor is specified in the operand, the half-word address constant generates a 2-byte constant containing 
the value of the expression in the constant subfield. The generated constant is aligned at a half-word boundary. If a 
length factor of 2 is specified, the generated constant is the same, but no boundary alignment takes place. If a length 
factor of 1 is specified, a 1-byte value is generated without any boundary alignment. 


Examples: 
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Pin SO ee ae 





; 





ay The preceding statements generate the following constants. (In each example, it is assumed that BOB has a 
ra value of 1446. This value may represent an main storage address or may be a binary value used for arithmetic 
purposes. The hexadecimal value equal to 1446 is stored as shown.) 





1. Two-byte constant, aligned on a half-word boundary, containing: 
CIS] A, 6 
2 Two-byte constant, unaligned, containing: 
0 5]A 6 
3 Two-byte field containing the 1-byte constant duplicated once as: | 





2.4.7.2. Base and Displacement Constants 





A base and displacement constant is specified by the character S in the type subfield and one or two expressions 
enclosed by parentheses in the constant subfield. The expressions may be absolute or relocatable. A length factor, if 

QL present, can be only 2. If no length factor is specified, the implied length of the constant is two bytes. Negative 
relocatable values are not permitted. This type of constant is used to store addresses in the base and displacement 
form; the leftmost four bits represent the base and the remaining 12 bits represent the displacement. If one 
expression is present, the assembler converts it to a base plus displacement value. If two expressions are present, the 
expression representing the base is enclosed in parentheses with the other expression (representing the displacement) 
preceding it and another set of parentheses enclosing the base and displacement specifications. The S-type constants 
may not be specified as literals. Adjustment to the half-word boundary is made only if no length specification is 
used. 








Examples: 





boa be Ph 





4{S ,Y M,B,O[L S,( J, 0, HIN, ) 


LABEL A OPERATION A OPERAND A 

1 10 16 a 
Hoi tis | sitar la.0,9,6 | 

Wretreed soccer s 

reer vas ieee ieee ea et es gui : 
A 11s | luisstinil |5,0,0,0,,19 

Peete 2 eireea le | 

Pe eneee tomer | 
JOHN 1, || | sto be 

Sesh Saisie i 

Keeeenee i | 

SuyMB,0jL, . | Ei 

sy MBoL,. | E 


51S.Y \M,B,0 jb SiC p29 C19 sy. i es eh ee ge 
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Assume that the constant with the label JOHN (line 3) is assigned an address value of 5025,, by the location 
counter, and that the USING directive (line 2) gives the value 5000 


10’ 










PAGE REVISION PAGE 


which is assumed to be in register 9 at 


execution time. The operands in the two statements (lines 4 and 5) produce the same stored base and 
displacement value. The hexadecimal representation of this stored value is 9019 as follows: 


1 BYTE 1 BYTE 
___ 





BASE DISPLACEMENT 


REGISTER (12 BITS) 


(4 BITS) 


NOTE: 


Refer to 4.4 for a description of the USING directive. 


2.4.8. Data Storage Definition Examples 


The programmer can reference a data storage area in many ways. By defining an area in terms of its smallest divisions 
or fields, each field can be referenced. The programmer can then use a DS statement with a O-duplication factor to 
define a label and give it a length attribute so that more than one field can be referenced simultaneously. 


The following example illustrates a typical data storage area and the subdivision of its fields: 





Sey ee 
h 
where: 
A 
Is a 40-byte field. 
B 


Is a 20-byte field. 


Cc 

Is a 10-byte field. 
D 

Is a 10-byte field. 
E 


Is a 20-byte field. 


2-20 














7508 Rev. 3 UNIVAC 9200/9200 11/9300/9300 Il SYSTEMS 


UP-NUMBER PAGE REVISION PAGE 


The following assembler coding example illustrates the ways DS instructions can be used to assign labels and length 
attributes to the fields of a data storage area: 


OPERATION A OPERAND A 
10 16 


0,C,L,4,0 
| Jo.c,L,2,0 


CL,1,0 ee el sa te te ee ee 


Pic | Bek es 
C,L,2,0 ' ; 


The first statement of the example does not reserve any storage but does define the label A and its length attribute 
of 40. Although the label of the second statement has the same value as the label of the first statement, the length 
attributes of the first and second statements are different. When using the labels in an SS-type instruction with 
implied lengths, one label (A) would reference 40 bytes, but the other label (B) would reference 20 bytes. 














2.5. STORAGE ADDRESSING 


Both direct addressing and indirect addressing may be used in the SPERRY UNIVAC 9200/9300 Series. Direct 
addressing is possible because the operand portion of an instruction is large enough to represent 32,767, the 
maximum main storage address available in the system. Indexed, or base and displacement, addressing also is 
possible. 


Indexed addressing is achieved by using part of the operand for an indexing indication and the remainder for a 
displacement value. Either actual index registers or pseudo registers may be used for the indexing indication. Using 
pseudo registers results in direct addressing that provides a relocatable code. 


2.5.1. Base and Displacement Addressing 


Inasmuch as the 9200/9300 series instruction format does not include an index register field, the first four bits of 
the operand itself are set aside for the index or register number. The most significant bit of each operand determines 
whether indexing is to occur. If that bit is a 1, indexing takes place; otherwise, no indexing is performed. 


Because 4 of the 16 bits of the operand are used for indexing, only 12 bits remain for the operand address. This 
partial operand is the displacement. Since the largest address that can be expressed in 12 bits is 4095, main storage is 
segmented into 4K blocks. 

The registers used for indexing are the processor general registers. They are numbered from 8 through 15. Because 
each of these numbers begins with a 1 when represented in hexadecimal notation, specifying a register forces 
indexing. The true main storage address consists of the contents of the register plus the value of the displacement. 


The USING assembler directive is used to notify the assembler that a specified register is available for base register 
assignment. The directive is explained in 4.4. The register must be loaded by the program with the value to be used. 
From the values supplied in the various USING directives, the assembler builds a base register table which it uses to 
compute the 12-bit displacements for operands. The computation of displacements continues to be based on the 
base register table until the displacement limit of 4095 is reached or until the assembler finds another register which 
was designated in a USING directive with a base address that yields a smaller displacement. 


2-21 
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The SPERRY UNIVAC 9200/9300 Series Operating System focator/loader routine places the transfer address of a 
main program in processor register 15 prior to transferring control to the program. The programmer may take Eee 
advantage of this fact by coding a USING directive containing the label of the first instruction to be executed and 

specifying register 15 as the base register, as: 


LABEL AOPERATIONA OPERAND A 






ae REA Se a i SES Or a Wc oe Re se SUE Ceo DO Ue 2 








ba a be a 
co at eee erase 
Re ee ee eee ee ee 
0,U.T,,, TWO, . . 4 : : a ae 

ate tt a a Pa 
ete a fy ee i ey 
Ate gece le ae ea ph Pp ee ee A et 


ee 
H,’ ,2,’ ‘ j Heforce rf 











LA,B.L fee i (GON os inp yd | 44 ae ae ee ee : 
Grime Maes oa om St at Pc Bes SR de . 
In this example, since register 15 was the base register in force at the time, the machine code generated at BEGN / 


might appear as: 





4880FE24 





Since the following line declared the availability of register 8 as a base register and since register 8 will now yield a 
smaller displacement than register 15 for any operands which address locations following GO, the machine code 
generated at GO might appear as: 


D2018E1C8E1E 


2.5.2. Pseudo Register Base and Displacement Addressing 


True base and displacement addressing requires index register modification of each instruction. Direct addressing is 
more desirable because it eliminates the extra cycles required to index each instruction, speeding up instruction 
execution. Direct addressing can be achieved by assembling the program with absolute addresses by using an ORG 
directive. With this method, however, the program cannot be relocated. 


Another type of addressing provides direct addressing and relocatable code, but does not require indexing of each 
instruction. This form of addressing uses pseudo registers. To designate a pseudo register, the USING directive 
format is: 





A OPERATION A OPERAND 
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Is the pseudo register number, from 0 through 7. 

As in true base and displacement addressing, the pseudo register USING directive provides a value for the base 
register table. But in this case, the values are not arbitrarily provided as a result of the label processing by the 
assembler; they are fixed values determined by the register number given in the USING directive. The register 
numbers 0 through 7 produce the table values: 

register 0 —O 

register 1 — 4096 

register 2 — 8192 

register 3 — 12,288 

register 4 — 16,384 

register 5 — 20,480 


register 6 — 24,576 


register 7 — 28,672 


When using pseudo registers, the operand displacement is determined in the same way as with actual registers. The 
nN displacement for an operand is computed by subtracting the table vatue that produces the smallest 12-bit : 
displacement from the label value. For instance, if TAG were at address 4100, this value would be shown as: q 


BASE DISPLACEMENT 


0001 000000000100 





Viewed as a base and displacement address, this operand shows a base register of 1 and displacement of 4. | 
(Remember that pseudo register 1 is the value of 4096.) The 16-bit address also is the binary representation of 4100: 4 
0001000000000100, the actual address of TAG. 4 


Since the pseudo register numbers range from O through 7, the most significant bit is zero. The operand, then, does 
not cause indexing and, when read as a binary number, is a direct address. 





True base and displacement addressing is advantageous only when the programmer must be concerned with later 
conversion to a processor with a main storage capacity exceeding 32K. Even then the use of pseudo registers may be 
preferable because the conversion requires reassembling the program, and the USING directives can be changed 
easily at that time. 
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3. Instructions 





3.1. GENERAL 





The SPERRY UNIVAC 9200/9300 Series Tape/Disc Assembler uses a repertoire of 35 machine instructions, which 
are described in this section. The instructions are listed in Tables 3-1, 3-2, 3-3, and 3—4. 


NOTE: 


The 9200 system is not provided with the divide packed decimal, multiply packed decimal, and edit instructions, 
except as optional features. If the optional hardware instructions are not installed, they may be simulated by 
UNIVAC-supplied fixed, closed subroutines, which duplicate the functions of the instructions. The use of the 
optional hardware instructions does not differ from that of the standard 9300 system instructions. The use of the 
software subroutines is described in the operational conditions of the instructions (3.3.1.5, 3.3.1.6, and 3.3.4.1}. 





or, The instructions are grouped by function in this section, as in Table 3—2. The function types are arithmetic, branch, 
comparison, data manipulation, data transfer, display, input/output, logical, and supervisor. Each type is analyzed 
and explained separately. The timing for the instructions is presented in Table 3—4. The symbols used in illustrations 
in this section are listed in Table 3—5. 


3.2. INSTRUCTION FORMAT 


The machine instruction format consists of an optional label, a mnemonic operation code, and one or two operands. 





A OPERATIONA OPE RAND 






{ symbol | operand 1, operand 2 


The label may be any symbol, as previously defined, but its use is not required. The mnemonic operation code for 
each instruction is specified in Table 3—1 and in the text explaining each instruction. The operands are of two 
forms, expressions, as previously defined, or complete specifications. Any symbol used in an expression must be 
defined within the program. A complete specification includes a base register and a displacement value. The 
specification is explicit and the assembler uses these numbers to compile the addresses of the operands. Each type of 
operand is illustrated in the example format: 





OPERAND 







A OPERATIONA 


D1(L1,B1), D2(L2,B2) 


expression, expression 
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Mnemonic 





Table 3—1. Instruction Mnemonics 


Add half word 

Add immediate 

Add (packed) decimal 
Branch and link 

Branch on condition 
Compare half word 
Compare logical character 
Compare logical immediate 
Compare (packed) decimal 
Divide (packed) decimal 
Edit 

Halt and proceed 

Load half word 

Load program state control 
Multiply (packed) decimal 
Move characters 

Move immediate data 
Move numerics 

Move with offset 

AND characters 

AND immediate data 

OR characters 

OR immediate data 

pack 

Subtract half word 
Subtract (packed)decimal 
Store program state control 
Supervisor request call 
Store half word 

Test 1/0 

Test under mask 

Translate 

Unpack 

Execute input/output function 
Zero add (packed) decimal 


Hexadecimal 
Operation 
Code 
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Arithmetic 


Branch 


Comparison 


Data 
manipulation 


Data 
transfer 


Display 


/0 


Logical 


Supervisor 


Table 3—2, Instruction Types 


Add half word 

Add immediate 

Add (packed) decimal 
Divide (packed) decimal 
Multiply (packed) decimal 
Subtract half word 
Subtract (packed) decimal 
Zero add (packed) decimal 


Branch and link 
Branch on condition 


Compare half word 
Compare logical character 
Compare logical immediate 
Compare (packed) decimal 
Test under mask 


Edit 
Pack 
Translate 
Unpack 


Load half word 
Move characters 
Move immediate data 
Move numerics 

Move with offset 
Store half word 


Halt and proceed 


Test 1/0 
Execute input/output function 


AND characters 
AND immediate data 
OR characters 

OR immediate data 


Load program state control 
Store program state control 
Supervisor request call 
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Hexadecimal 
Operation 
Code 
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Table 3-3. Instruction Formats 


Hexadecimal 
Operation 
Code 


Store half word 

Branch and link 

Branch on condition 

Load half word 

Compare half word 

Add half word 

Subtract half word 

Test under mask 

Move immediate data 

AND immediate data 

Compare logical immediate 

OR immediate data 

Store program state control 

Supervisor request call 

Execute input/output function F 
Test 1/0 & 
Add immediate : 
Load program state control 

Halt and proceed 


Move numerics 

Move characters 

AND characters 

Compare logical character 

OR characters 

Translate Nad 
Edit 


Move with offset 

Pack 

Unpack 

Zero add (packed) decimal 

Compare (packed) decimal 

Add (packed) decimal : 
Subtract (packed) decimal i 
Multiply (packed) decimal : 





Divide (packed) decimal 
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Hexadecimal 


Operation 
Code 


NOTES: 


E 
character instruction. 
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Table 3—4. Instruction Execution Times (Part 1 of 2) 


Store half word 
Branch and link 
Branch on condition 


Load half word 
Compare half word 
Test under mask 


Move immediate 

AND immediate data 
Compare logical immediate 
OR immediate data 

Store program state control 
Supervisor request call 
Execute 1/O function 


Test 1/O status 


Add immediate 
Load program state contro! 


Halt and proceed 

Add half word 

Subtract half word 

Move numerics 

Move character 

AND characters 

Compare logical character 
OR characters 

Translate 

Edit 

Move with offset 

Pack 

Unpack 

Zero and add 

Compare (packed) decimal 
Add (packed) decimal 
Subtract (packed) decimal 
Multiply (packed) decimal 
Divide (packed) decimal 





@ Timing for all instructions assumes no indexing. Add 3.6 microseconds for each indexing operation. Timing is given for 9300 
systems; for 9200 systems, multiply by two, 


@ N, N,. and Ny equal the number of bytes specified in the length of the operand. 


@ N. equals the number of most significant bytes that compare identically between OP1 and OP2 in the compare logical 4 
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Times 
EES 5) 


20.4 

18.0 

15.6 if no branch 

18.0 if no branch 

20.4 

20.4 

16.8 if no match or match on zero 
19.2 if partial or full match 

16.8 

16.8 

16.8 

16.8 

24.0 

12.0 

18.0 for integrated 1/O units; variable 
for multiplexer 

18.0 for integrated I/O units; variable 
for multiplexer 

19.2 

24.0 to load entire PSC word; 
18.0 otherwise 

14.4 

20.4 


20.4 

16.8 +8.a(nj® 

16.8 + 8.4(N) 

16.8 + 8.4(N) 

25.2 + 8.4(N @ 

16.8 + 8.4(N 

16.8 + 14.4(N) 

See 

25.2 + 3.6(N5) + 6(N,) 
25.2 + 3.6(N.) + 4.8(N,) 
21.6 + 7.2(N.) + 4.8(N,) 
26.4 + 3.6(N.,) + 4.8(N,) 
26.4 + 3.6(N.) + 4.8(N,) 
26.4 + 3.6(N.) + 4.8(N,) 


26.4.4 3.6(N.) + 4.8(N,) 
. 2 1 
Se 4) 


e 
e 





. 
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(@) Detailed formulas for the edit, multiply, and divide instructions are: 
a Edit (ED) 
30+ 6S, + 14N + BINDS + Ngo) +615 + 6, 
2 Multiply (packed) decimal (MP) 
52 + 13 (N, — Nj) + (16+ 14N5) ) MMD + (22 + 14N4) 
SLM + 24 (NMMDO) + 61, +61, + 14 


|OP2| largest (N, + No) 
(> (SS MMD | integer + BAU 
192N2~1 in 2 


This term gives an upper and lower limit (note the + sign) for a specific MP instruction using the actual values of OP1 and 
OP2. A series of MP instructions executed with random numbers for operands yielded an average execution time of 28 
(N, —N.,). 

1 2 





Table 3—6 consists of a hardware timing chart that can be used to approximate the times required for multiplication 
, Operations. 


® Divide (Packed) decimal (DP) 


56 + 8N, + 6N, + (30+ 14N,) ) (MQD + 1) + (22+ 14N5) ) LOD +6l, + 61, 


where: 

Nps = the number of digit select bytes in OP1 of edit instruction. 

Ngg = the number of significant start bytes in OP 1 of edit instruction. 

Sy = the total number of signs in all the bytes accessed for OP2 of edit instruction. 

MMD = the value of a nonzero multiplier (OP 1) digit positioned in the most significant 
half of a byte. 

NMMDO = the number of zero multiplier (OP 1) digits positioned in the most significant 
half of a byte. The No most significant bytes of OP1 are excluded. 

LMD = the value of a multiplier digit positioned in the least significant half of a byte. 

MOD = the value of a quotient digit positioned in the most significant half of a byte. 

[Rorn) = the tens complement of quotient digits positioned in the least significant half 
of a byte. . 

‘OP2’ = multipticand digits 

', = 0 if operand 1 is not indexed; 1 if indexed. 


ln = 0 if operand 2 is not indexed; 1 if indexed. 
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Table 3—5. Instruction Symbols 





The number of the general register that holds the base address of operand 1. 
The number of the general register that holds the base address of operand 2. 
The mnemonic operation code of the instruction. 

The displacement from the base address of operand 1. 

The displacement from the base address of operand 2. 







The immediate data used as operand 2 in SI format instructions. 

The length of operand 1 as stated in source code.* 

The length of operand 2 as stated in source code.* 

Operand 1. 

Operand 2. 

The number of the genera! register that holds operand 1 in RX format instructions. 
The expression or symbolic label used as operand 1. 

The expression or symbolic label used as operand 2. 












* The length is coded as the true length of the operand, not the length less 1 as required by the object code. The assembler makes 
the appropriate reduction by 1 when converting source code to object code. 







Table 3—6. Hardware Multiply Timing Chart 







Multiplicand Digits (OP2) 

2 3 4 5 6 7 8 9 10 11 12 13 14 15 
EEO ccecooo 
[ene ofl oe] || 5] | 
Ee 
[nl va ea 02] ar] a] ava aaa] ae al a] a 
212m se] 2 es] 2] ane a9 | 
fees [>| | 3 920 
Fs rd 
ss on se so so of ef] 5 vn 
sn ns os so 
seen] a] 7] re] 70] 70] 76] m4] 9 97 : 
oo eo e[ anf ono an oom 


o>] s| 2m] so 











= 
-% 
ic} 
£ 
2 
a 
s 
2 
i 





1.291 


TIME IN MILLISECONDS 





NOTE: 


The times are averages based on a multiplier consisting of fives. To find 9300 system times, use half the figure in the chart. 
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3.2.1. Source Code [Instruction Format 


Four instruction format types, the RX, SI, SS1, and SS2 are available. The type of data field processed and the type 
of processing determine the format of the instruction. The RX format is for instructions that process data in fixed 
lengths and usually involves the use of a general register. The SI format is for instructions that process data 
immediately specified as one of the operands. SS1 and SS2 formats are for instructions that process data in variable 
lengths; SS1 is used when the operands are of equal length, and SS2 is used when they are determined 
independently. 


The four instruction format types are shown in Table 3—7. 


3.2.1.1. Register and Indexed Storage Operation (RX) 





The RX format is used by 4-byte instructions with the form: 










A OPERATION A OPERAND 


ea ge 
Rl, tag 








[symbol] 


The RX format instructions are used to process fixed-length data fields with a length of two bytes. One operand 
usually specifies a general register. Functions such as branching, comparing, adding, storing, and loading are 
performed by instructions in this format. 





3.2.1.2. Storage and Immediate Operand Operation (S!) 


The SI format is used by 4-byte instructions with the form: 









A OPERATION A OPERAND 











[symbol] D1(B1),12 | 


symbol,I2 f 


The SI format instructions are used to process data one byte in length, using control or additional data contained in 
the immediate operand. Logical, arithmetic, manipulative, and testing functions are performed by instructions in this 
format. 


3.2.1.3. Storage to Storage Operation (SS1) . 


The SS1 format is used by 6-byte instructions with the form: 









A OPERATION A OPERAND 


{ Dre ata 
symbol,tag 









[symbol] 
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The SS1 format instructions process data of variable length, up to a maximum of 256 bytes, if the operands specify 
fields of equal length. Functions such as comparing, transferring, and translating are performed by instructions in 
this format. 


3.2.1.4. Storage to Storage Operation (SS2) 


The SS2 format is used by 6-byte instructions with the form: 





A OPERATION A OPERAND 





[symbol] 





D1(L1,B1),D2(L2,B2) 
symbol,tag 


The SS2 format instructions process data of variable-length operands, to a maximum of 16 bytes, when the operands 
are not of equal length. The SS2 format is used with all packed decimal instructions. Functions such as shift 
operations, pack, and unpack are performed by instructions in this format. 











3.2.2. Object Code Instruction Format 


The format of the instruction repertoire in object code differs from source-code format. The hexadecimal 
object-code format is used in the printed listing that accompanies an assembly; the main storage dump also uses the 
object-code format. This format is illustrated in Table 3—7. 





An example of an assembly printout is shown in Figure 3—1. 


The object code in the third column of Figure 3—1 for the first instruction in the illustration is ABAOBOOO. The 
interpretation of the object code is: 


AB subtract half-word operation code 
A OP? register 

0 not used 

B register holding OP2 base address 


000 OP2 displacement 


The object code of the second instruction (line number 004) in Figure 3—1 is interpreted as: 





96 OR immediate operation code 
FB immediate data in OP2 . 
9 register holding OP1 base address , 


011 OP1 displacement 
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Table 3—7, Instruction Object-Code Formats 


——N a eee 
code* DC B2 D2 
7 Va 16 19420 31 


code* 
15]16 19 {20 


Ee 
0 718 15}16 19120 31]32 35/36 47 


code* L1 L2 Bl Dl D2 
0 778 ALfl2 154/16 19}20 31432 35/36 47 


*Using abbreviations as listed in Table 3~5. 





*Using abbreviations listed in Table 3—5. 


OBJECT SOURCE 

LINE ADDRESS OPERATION LABEL OPERATION OPERAND COMMENTS 
NUMBER CODE CODE 

9300 SYSTEM ASSEMBLY OF STST DATE 04/15/73 — >AGE 001° 
0001 2000 STST START 8192 

0002 USING “2 

0003 2000 ABA0B000 RX SH 10,0(,11) 

0004 2004 96FB9011 sl ol 17(9),X‘FB’ 

0005 2008 D120C005D00B $s1 MVN 5(33,12),11(13) 

0006 200E F8DD8047F056 $S2 zaP 71(14,8),86(14,15) 

0007 2014 000000002000 END STST 


Figure 3—1. Assembly Listing 
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The object code of the third instruction (line number 005) in Figure 3—1 is interpreted as: 





D1 move numeric operation code 
20 length minus one of the operands : 
Cc register holding OP1 base address 4 
005 OP1 displacement 

D register holding OP2 base address 


00B OP2 displacement 


The object code for the fourth instruction (line number 006) in Figure 3—1 is interpreted as: 





F8 zero and add operation code 

D length minus one of OP1 

D length minus one of OP2 

8 register holding base address of OP1 


047 OP1 displacement 
F register holding base address of OP2 
056 OP2 displacement 


To facilitate understanding of the object-code form of the instructions, each instruction is accompanied by a small 
box containing information pertinent to the interpretation of the object-code instruction format. Each instruction 
type, RX, SI, SS1, and SS2 is in its own object code format, as illustrated in Table 3—7. 


The relationship between source- and object-code formats is illustrated for the zero and add packed decimal 
instruction (3.3.1.9): 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE | HEXADECIMAL) =OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





D,(Lj,B1),D2(L2,B2) 6 BYTES 






BYTES 


0 1 2 3 4 5 
0 748 1112 5 416 \ 19420 31 32/35 436 47 


Wea 


\4 
A 5 
P 


BITS 








a aS = 
Z|A TV C141, 8) Bl C4 INS be 





yeas es oe Tae ms a eo peer eras gece ee yO Pa te Fey tem Vel nerd ol) fgets ie Ae tes ot fe slate deed 





The box that accompanies each instruction provides the programmer: the hexadecimal operation code, as F8 for 
ZAP; the format type, SS2 in the example; the number of bytes the instruction will occupy in main storage, six 
bytes, in the example; and the mnemonic operation code, ZAP. 
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3.2.3. Implied Base Register and Length 


The complete specification of an operand consists of a displacement and base register to form the address, and a 
length to determine the size of the operands. If the address is in implied form. The assembler then provides the 
addresses of the operands. Information supplied in the USING and DROP assembler directives enables the assembler 
to do this. The length attribute associated with the expression is determined by the assembler according to the rules 
explained in 2.3.6. The complete and implied form for each instruction format type is shown in Table 3—8. 


Table 3—8. Complete and Implied Specifications for Operands 


Specification 
Type 


Complete 
Relative address 
Complete 
Relative address 


Complete D1(L1,B1) 


Relative address 
Relative address and length 
Relative address and length 





NOTE: 
Symbol and tag can be any symbol,as defined in 2.3.4. Explanation of the notation used in this chart is in Table 3—5. 


If the length is not specified in an implied operand, it is determined by the assembler, as explained in 2.3.6. 


3.3. INSTRUCTION REPERTOIRE 


The entire range of machine instructions for the tape/disc systems is presented in the following paragraphs. Each 
instruction is shown under its own heading consisting of the full instruction name. Under each heading is a block 
containing the instruction type, mnemonic operation code, symbolic source-code operand format, hexadecimal 
operation code, and object instruction length for the instruction. (Refer to 3.2.1 and Tables 3-1 through 3-4.) 


The block is followed by a function abbreviation using OP1 and OP2 to refer to the operands, parentheses to mean 
“the contents of,” and an arrow to indicate the storage of the result. The function 


(OP1) - (OP2) > OP1 


means “the contents of the bytes addressed by the first operand are multiplied by the contents of the bytes 
addressed by the second operand and the result is stored in the bytes specified by the first operand.” 


A description of the operation of the instruction is given next, followed by operational conditions, and, in cases 
where it is necessary for clarity of explanation, an example of the working of the instruction. 


The section for each instruction closes with examples of the instruction used in a line of source code as it would be 
written by a programmer. 
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3.3.1. Arithmetic Instructions 


QU 

The arithmetic instructions add, subtract, multiply, or divide values stored in main storage, in registers, or in 
immediate operands. 
The arithmetic instructions include: 

Mnemonic Function Format 

AH Add half word RX 

Al Add immediate SI 

AP Add packed decimal ss2 

DP Divide packed decimal $S2 

MP Multiply packed decimal! S$S2 

SH Subtract half word RX 

SP Subtract packed decimal SS2 

ZAP Zero and add packed decimal $S2 
The formats of the arithmetic instructions vary with the function of the instruction and the type of data operated 
upon. The result of the execution of the instruction is stored in the first operand of each instruction. The condition 
code is changed by most of the arithmetic instructions; the exceptions to this are the divide packed decimal and 
multiply packed decimal. The operands are processed from left to right in most instructions; the exceptions are the 
packed decimal instructions. The instructions are explained separately in the text and are accompanied by notes on 
their limitations and operations. 

ron 

3.3.1.1. Overflow 


Binary arithmetic instructions set the condition code after execution. A condition code setting of 3 denotes that 
overflow occurred during execution of the instruction. Overflow is a condition occurring when the sign of a numeric 
field, expressed in binary format, is changed erroneously. The sign change can occur when an attempt is made to 
develop a larger number than can be expressed in 15 bits. Because all binary data must fit into two bytes, one bit of 
which must be the sign, the maximum expressible numbers are +32,767 and —32,768. 








Example: 
OP1 0010101101101000 ( 11,112) 
Sign 
plus OP2 0101010010011000 (+ 21,656) 
Sign : | 
Result 1000000000000000 (- 32,768) 
Sign 


An add half-word instruction using the foregoing operands, by adding OP2 to OP1, results in a number, stored in 
OP1, of —32,768 instead of the true answer +32,768. The true answer does not fit in 15 bits and the sign bit is 
changed by execution of the instruction. 
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3.3.1.2. Add Half Word 





INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HE XADECIMAL OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 
CODE CODE LENGTH 
Function: 


(R1) + (OP2)> R1 
Description: 


Execution of the add half-word instruction adds the contents of the half word specified by OP2 to the 
contents of the register specified by R1; the result is stored in R1. 


Operational conditions: 
1. The OP2 address should be defined at a half-word boundary. 


2. The condition code is set as follows: 


Result is zero. 
Result is negative. 
Result is positive. 
Overflow occurred. 


WH Oo 


Examples: 







A OPERATION A OPERAND A COMMENTS 
10 16 


Bhi 4)s pL gy 1C,OM,P,LIE,TIE, SjPLE,C1 Fit, CAT 1O,N 
aTOTA pr tir pIRELATIVIE, AD ORESIS 7 ty 











3.3.1.3. Add Immediate 


MNEMONIC HEXADECIMAL| OBJECT 
INSTRUCTION SYMBOLIC SOURCE CODE 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 
CODE CODE LENGTH 





Function: 
(OP1) + 12> OP1 
Description: 
Execution of the add immediate instruction adds the binary value specified by the immediate operand, |2, to 


the contents of the half word specified by OP1; the result is stored in OP1. The immediate operand may be 
written in any of several forms. (See examples.) 
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Operational conditions: 
1. The most significant bit of the immediate operand is treated as a sign in a binary field. The !2 field is 
sign-extended by the hardware before execution of the instruction. Specifying a negative value for I2 
results in OP1 being decremented by that value. 


2. | The OP2 address should be defined at a half-word boundary. 


3. The condition code is set as follows: 






0 Result is zero. 
1 Result is negative. 
2 Result is positive. 
3 Overflow occurred. 
Examples: 
LABEL AOPERATIONA OPERAND A COMMEN 
10 16 
pita tbo pf Abb 2.0 (1,405 .:2,5) | i 1 pC, OM,P. LIE, TE, iS/P 
os ae oer ee ee Alloua BASF. 1M .3,3) 0 Fy TREE ATH VE, WALD 
poor tli i | Abbi se | IBA SF. t-i2) 5 Po RIEL A TIIVVE, ADORE SS. yt 


3.3.1.4. Add Packed Decimal 


MNEMONIC HEXADECIMAL| OBJECT 
INSTRUCTION SYMBOLIC SOURCE CODE 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 


Function: 





(OP1) + (OP2) > OP1 
Description: 
Execution of the add packed decimal instruction causes the algebraic addition of the bytes specified by OP1 to 


the bytes specified by OP2. The result is stored in OP1. Both OP1 and OP2 should contain packed decimal 
fields. 





Operational conditions: 


1. Operands are processed from right to left. 





2. ‘If OP1 is shorter than OP2, the excess digits of OP2 are ignored; if OP2 is shorter than OP1, zeros are 
assumed to extend OP2. 
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3. OP1 and OP2 may occupy the same, or some of the same, bytes in main storage without affecting the 
operation of the instruction only if the low-order bytes of the two operands coincide in main storage. 


ae 


4, If overflow occurs, the sign stored in OP1 always reflects the sign of the true answer. The sign of a zero 
is positive in all cases other than overflow. 


5. |The maximum size of operands is 16 bytes. 


6. Thecondition code is set as follows: 


0 Result is zero. 

1 Result is negative. 
2 Result is positive. 
3 Overflow occurred. 


Examples: 







COMMENTS 










| lo.6 « 6,191) 3,141 8) COMPLIETE, SPE CURA CATION | 1 yy 


ti Halts ff 6 iC It eB MPD, GLEIN,G TH, | a tt 


| [peeps RIA TIE, ( 141), [RELA TEV E, ADORE SS, . . 4. 1s tes 



























3.3.1.5. Divide Packed Decimal 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CoDE | HEXADECIMAL OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE _ CODE LENGTH 





Function: 


(OP1) + (OP2) > OP1 
Description: 


Execution of the divide packed decimal instruction divides the contents of the bytes specified by OP1 by the 
contents of the bytes specified by OP2 as the divisor. The quotient and remainder are stored in OP1. Both OP1 
and OP2 should contain packed decimal fields. 


Operational Conditions: 


1. The following pertains to the 9200 system optional software versions of this instruction; also see card 
utility programs programmer reference manual, UP-4120. 


B The software divide and multiply functions are provided by one fixed, closed subroutine which is 
in relocatable object code and requires approximately 450 bytes of main storage. The 
multiply/divide subroutine must be linked to the problem program. To make the linking possible, 
the following source code statement is necessary: 














7508 Rev. 3 


/UP-NUMBER 


UNIVAC 9200/9200 11/9300/9300 I! SYSTEMS 








PAGE REVISION 


a The source code necessary to accomplish the instruction is: 
















LABEL A OPERATION A OPERAND 6 
1 10 16 j 
poe | fepetie nt [MPD 


a The software version of the instruction differs in that: 





- OP1 length must be defined in the instruction; the length is not determined by the recognition ofa 
sign in the field. 


Maximum length of OP2 is eight bytes. 

A divide check error in the software version causes a display of 29EE. 
2. Operands are processed from right to left. 
3. The length provided for OP1 must be large enough to accommodate both the quotient and a remainder. 4 


If the length provided is not sufficient, the answer is unreliable and bytes beyond OP1 may be affected 
by the execution of the instruction. 


by ieee eS 


A formula for determining a sufficient length for OP1 is: 
L=dtv 
where: 
L = length of OP1 in bytes. 
d = length of the dividend and sign in bytes (minimum of 2). 


v = length of the divisor and sign in bytes. J 
All fractions rounded to the next higher integer. 


aad Soho Rin the ee ere 


This formula yields a length that meets or exceeds the requirements of the instruction. 





4. Both dividend and divisor must be right-justified in their respective fields; leading zeros mist fill the : 
fields. ‘ 

5, At least one leading zero must precede the dividend. The absolute value of the divisor must be larger 
than the absolute value of the L2 most significant bytes of OP1. If these requirements are not met, a 
decimal-divide exception occurs and the processor halts. 


6. OP2and OP1 cannot overlap in main storage. 


7. OP2 cannot exceed 16 bytes. 
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8. After execution, OP1 contains the quotient right-justified in the most significant bytes. Its length equals 
L1 minus L2 bytes. The remainder, if any, is right-justified in the least significant bytes of OP1; the 
length of the remainder equals L2. Leading zeros pad the quotient and the remainder. 

9. The sign of the quotient is determined by the rules of algebra. The sign of the remainder is the same as 
the sign of the dividend. 

10. If a quotient digit greater than 9 is formed, a divide-check error occurs and the processor halts. 

11. Division by zero produces a decimal-divide exception. 


— 


2. Execution of the instruction does not change the condition code setting. 


13. An example of the use of the instruction is: 


OPERATION i OPERAND A 








C,L,4 pore trai tay iit 


f 
| lp v.p,, NU M1 
- 
i 





DS ;0,Ry, INU) M2 
| [bt V,D,,;0,8 OR 


O,U,T)14( 16 DILV,D ee 
Mv. O.U)T A Dil LV, +16 


In the sample source code, two storage areas labeled DIVD and DSOR are defined in lines 1 and 2. After 
Processing of the problem program, data is moved to the storage area in lines 4 and 5. For the example, 
DIVD now contains the number: 

00 00 00 00 99 03 05 07 00 1, 
DSOR contains the divisor: 

03 00 04 0, 
Execution of the divide instruction, as coded in line 6, stores the quotient and the remainder in DIVD: 


00 00 03 30 05 74 02 02 72 14 


The quotient is right-justified in the most significant bytes of DIVD, and the remainder is right-justified 
in the least significant bytes. The remainder always occupies the same number of bytes as OP2. 


In the rest of the example coding, the result of the division is moved to separate data fields. 
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Examples: 









A OPERATION A 
10 16 





OPERAND COMMENTS 











28 VOL US) 1804.4), sy COMPLETE, SPECIFY CATION | 
Dili Vi O10), DU SRC 4) y ps IRAE A TIE VE, AOD, RESIS, ty a ta 
LV. IOSOR 1, pp rp ty pp MPL ICT, LIEN, G TH] AND, {AD 0,R,E/S, 5S, 
pore tdinr ativan dei ri tiie i tii tiriitiiriitii rit ia 








3.3.1.6. Multiply Packed Decimal 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HEXADECIMAL OBJECT 
TYEE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 


(OP2) - (OP1) > OP1 

Description: 
Execution of the multiply packed decimal instruction multiplies the contents of the bytes specified by OP2, 
the multiplicand, by the contents of the bytes specified by OP1, the multiplier. The result is stored in OP1. 
Both OP1 and OP2 should contain packed decimal fields. 


Operational Conditions: 


1. The following pertains to the 9200 system optional software versions of this instruction; see also card 
utility programs programmer reference manual, UP-4120. 


a The software multiply and divide functions are provided by one fixed, closed subroutine in 
relocatable object code requiring approximately 450 bytes of main storage. The multiply/divide 
subroutine must be linked to the problem program. To make linking possible, the following source 
code statements are necessary: 


X:Ti.RIN| [M,P,D,P * 





The source code necessary to perform the instruction is: 
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a The software version of the instruction differs in that: 


- OP1 length must be defined in the instruction; the length is not determined by the 
recognition of a sign in the field. 





— Maximum length of OP2 is eight bytes. 


— The multiplier is OP2, and the multiplicand is OP1 in the software version of the instruction. 
The result is still stored in OP1. 


Operands are processed from right to left. 





The length provided for OP1 must be equal to the number of bytes specified for OP2, plus the number 
of bytes needed to express the multiplier. The multiplier cannot be longer than L1 minus L2. 


Zeros must fill the leftmost bytes of OP1. 

Any excess length of the multiplier in OP1 will be ignored during execution. 

The sign positions of both operands must contain values greater than nine. 

The sign of the result is determined in accordance with the normal algebraic rules. 
The maximum length of OP2 is 16 bytes. 

OP1 and OP2 cannot overlap in main storage. 


Failure to meet the requirements results in an unreliable product, but does not set an error indication. Set 
The bytes beyond OP1 can be affected by execution of the instruction unless the requirements are met. 


Execution of the instruction does not change the condition code setting. 
An example of the use of the multiply packed decimal instruction follows: 
To multiply 800 by —80, the multiplier would be 
08 OD 
OP2, the multiplicand, would be 
80 OF 


To fulfill the requirements of the instruction, OP1 contains the multiplier and a number of bytes 
equal to OP2. The total four bytes look like 


00 00 08 OD 
After execution OP1 contains 


00 64 00 OD 










321 
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Examples: 





A OPERATION A OPERAND A COMMENTS 
10 16 


Vi 4a 9) eV 2 HOt, (COMP LIE, TE, SPEC dF CATION, | py 
WE, XC 4 ) 14 LE, R200 4 |. re pe Gras ast JR,EL AT! VE, AD DRESS, 4.2 toa = ae eae | i 0.5 
MEX HIER | ti iil y MPL UC 1, T, LENGTH) AND, JAD OR ESS, 








ites E rt 





cla Cs es ey Ds Ec Cl ER We Ce UU LO tne CR Py Levey rs ry We dL 





3.3.1.7. Subtract Half Word 


MNEMONIC HEXADECIMAL| OBJECT 
INSTRUCTION SYMBOLIC SOURCE CODE 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 


(R1) — (OP2)>R1 
Description: 


Execution of the subtract half-word instruction subtracts the contents of OP2 from the contents of R1. The 
result is stored in R1. 


Operational conditions: 
1. The OP2 address should be defined at a half-word boundary. 
2. The condition code is set as follows: 
0 Result is zero. 
1 Result is negative. 
2 Result is positive. 
3 


Overflow occurred. 


Examples: 






144,,:8,01( i tt) | 11 LOOM PLETE SPECI FICATION |, 
M4: FUSCA fa RE WA TIVE AID ORE SIS, 2 ba 


pore de pega ta 
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3.3.1.8. Subtract Packed Decimal 


MNEMONIC HEXADECIMAL| OBJECT 
INSTRUCTION SYMBOLIC SOURCE CODE 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 


Function: 





(OP1) — (OP2)— OP1 

Description: 
Execution of the subtract packed decimal instruction subtracts algebraically the bytes specified by OP2 from 
the bytes specified by OP1. The result is stored in OP1. Both OP1 and OP2 should contain packed decimal 
fields. 

Operational conditions: 


1. The operands are processed from right to left. 


2. ‘If OP1 is larger than OP2, zeros are assumed to extend OP2. If OP2 is larger than OP1, the remaining 
digits of OP2 are ignored. 


3. OP2 and OP1 may occupy some, or all, of the same bytes in main storage without affecting execution of 
the instruction only if the low-order bytes of the operands coincide in main storage. 


4. If overflow occurs, the sign stored in OP1 will reflect the sign of the true result. The sign of a zero is 
always positive, except in overflow conditions. 


5. The maximum size of operands is 16 bytes. 
6. The condition code is set as follows: 

O Result is zero. 

1 Result is negative. 

2 Result is positive. 


3 Overflow occurred. 


Examples: 





OPERAND A COMMENTS 





A OPERATION A 
10 ii 


7,3,0,6), {1,0 7 36 ,.(,3,, ,140,) COMPLETE, 1S,P,E;C 1 FE CiA, Tt ON] je S 
73eC M0) 76 CTO MPO) LENGTA tt 
HRS. K1(.6.)  HIRS,0,U,(13), REILAT VIE, ADDRESS, 1,,,,1,,1,;1 
HRS WAKE HR SOU ty I MPL EGU T, LE NIG TH, (AIN,D, |A DID. RES S| 
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3.3.1.9. Zero and Add Packed Decimal 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HEXADECIMAL OBJECT 
TYPE OPERATION OPERAND FGRIAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 








Function: 


De erate PRE Ie 


0-> OP1; (OP2) > OP1 


Pee re a 


Description: 


Execution of the zero and add packed decimal instruction clears the bytes specified by OP1 to zero and stores 
the contents of the bytes specified by OP2 in OP1. To avoid unpredictable results, OP2 should contain a 
packed decimal field; no restriction is placed on OP1 because its contents are overlaid by execution of the 
instruction. 





Operational conditions: 
1. Operands are processed from right to left. 


2. If OP1 is larger than OP2, the excess positions of OP1 will be zero filled. If OP2 is larger than OP1, the 
Most significant bytes of OP2 are ignored. 


3. OP1 and OP2 can overlap in main storage only if the rightmost byte of OP1 coincides with, or lies to the 
right of, the rightmost byte of OP2. 


4. If the same field is designated as both OP1 and OP2, the field remains unchanged. 
5. The maximum size of operands is 16 bytes. 


6. The condition code is set as follows: 





Q OP2 is zero. 
1 OP2 is negative. 
2 OP2 is positive. 





Examples: 
















A OPERATION A 
10 1 





OPERAND COMMENTS 





4.110.144}, By) ue 18160164 0,11 51), 1» ICOM PLIE TE, SIPE,CI FILCATIION | fy 
4 VC By BS CUS | a EM PED EL EINNG TA, | 
HEV BCI14) ER GER 114) 1 IRE ATH VE, AID D RESIS, ta 4 
HEY BERGER) i ti MP ECT, JLiE.N, GT Hi VAN, D, jA, 0D. REISS, 
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3.3.2. Branch Instructions 


Flexibility of program coding is provided with the branch instructions. Used after an instruction that changes the 
condition code setting, the branch instructions test the condition code and change the coding path according to the 
programmer’s intentions. The branch and link instruction affords the additional device of allowing the program to 
return to the starting point of the varying path. The branch instructions are: 


Mnemonic Function Format 
BAL Branch and fink RX 
BC Branch on condition RX 


The assembler affords extended mnemonic codes as shorthand symbols to facilitate the writing of branch 
instructions. The extended mnemonic codes are listed in Table 3—9. All of these codes represent the branch on 
condition instruction with different code settings in the R1 field of the instruction format. 


The branch on condition instruction tests the condition code setting but does not change it. The branch on 
condition and branch and link instructions are explained separately in the text and are accompanied by notes on 
their limitations and operations. 


3.3.2.1. Branch and Link 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE | HEXADECIMAL; OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 


Branch to OP2; store address at R1 
Description: 

The branch and link instruction affords an unconditional branch to the address specified by OP2 
Operational conditions: 


1. Because the OP2 address is accessed first during execution of the instruction, no conflict is inherent in 
specifying the same register for R1 that is used as a base register in the indexed address of OP2.* 


2. Execution of the instruction does not change the condition code setting. 


Examples: 






A OPERATION A OPERAND A COMMENTS 
16 






810.(1, 1432) 1 [€,0,M, PL] ET,£, |S|P,E.C1, F/I, CAT! ION 
BRT Fh, yp Py TRIER ATIVE, ADDRESS 7 yt 
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3.3.2.2. Branch on Condition 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HE XADECIMAL OBJECT 
+ VpE OPERATION OPERAND COaHAT OPERATION | INSTRUCTION 
CODE CODE LENGTH 





Function: 


If match branch to OP2 


Description: 


Execution of the branch on condition instruction tests the condition code setting with the mask specified by 
the R1 bits, and, if the test is met, a branch to the address specified by OP2 is executed. If the test is not met, 
the next instruction in sequence after the branch instruction is executed. 


Operational conditions: 


1. Each 1 bit in the R1 mask tests one of the four possible condition code settings. More than one bit can 
be used in the mask to test more than one condition code; the branch to the OP2 address occurs if one 
or more of the conditions is present. 


Condition Code Ri 
0 8 
1 4 
2 2 
3 1 


2. — If R1 is zero, the result is a NO-OP; if R1 is 15, the result is an unconditional branch to the OP2 address. 
3. Execution of the instruction does not change the condition code setting. 


Examples: 
















COMMENTS 





A OPERATION A OPERAND 
10 


16 











BiG, i ft BLO 4A ef C,OLM PLE, TE, SyPLE Ct FUCA TION, 
Bic, 1 1 Bi iPROBA ci lig i a JRE LA TIVE, AID O,RESIS, . yp] pias 
WS NEXT 1 | a TUN COND IT OIN AL, BIRAIN; GH) oy 


ONT pee a a ESP a a a 
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3.3.2.3. Extended Mnemonic Codes 


The extended mnemonic codes use the following format: 





A OPERATION A OPERAND 





[symbol] 





where: 


code 
Ils any mnemonic as listed in Table 3—9. 


D,(,B,) 





ls an address, either complete specification or relative form. 


Table 3-9. Extended Mnemonic Codes 


Hexadecimal 
Operation 
Code 


Branch 47 
No operation 47 
Used After Comparison Instructions 
Branch if high 47 
Branch if low 47 
Branch if equal 47 
Branch if not high 47 
Branch if not low 47 
Branch if not equat 47 
Used After Test Under Mask Instructions 
Branch if all ones 47 
Branch if all zeros 47 
Branch if mixed 47 
Branch if not all ones 47 
Branch if not all zeros 47 
Branch if not mixed 47 
Used After Arithmetic Instructions 
Branch if overflow 47 
Branch if zero 47 
Branch if minus 47 
Branch if positive 47 
Branch if no overflow 47 
Branch if not zero 47 
Branch if not minus 47 
Branch if not positive 47 


om 





NOOO AN 





onmsponm 


ODNMNF OD 





The format is a variation of the RX instruction format. The assembler uses the extended mnemonic to form both the 
operation code and the R11 field of the instruction. 


Examples: 









A OPERATION A OPERAND A COMMENTS 
10 


16 
24 UC thd a tae. {COMP LIE TE, SIPEC IF CATION, | 
GQUTAP VITA, Go bia p RIEL ATELY E, AD DRESIS | ba 
PRIPiBi foi i be IRE ATH IVE, ADD RESIS, pb 
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3.3.3. Comparison Instructions 


ee The comparison instructions compare, either logically or algebraically, the contents of a location in storage to the 
contents of a register, of another storage location, or of an immediate operand. The comparison instructions include: 


Mnemonic Function Format 
CH Compare half word RX 
CLC Compare logical character SS1 
CLI Compare logical immediate SI 

cP Compare packed decimal SS2 
T™ Test under mask SI 


The formats of the comparison instructions vary with the function of the instruction. The data compared is not 
altered in memory. The condition code is set by all the comparison instructions. The operands are processed from 
left to right in most cases; in the compare packed decimal instruction the operands are processed from right to left. 


The instructions are explained separately in the text and are accompanied by notes on their limitations and 
operations. 


3.3.3.1. Compare Half Word 



















MNEMONIC 















INSTRUCTION SYMBOLIC SOURCE CODE =| HEXADECIMAL OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 
CODE CODE LENGTH 
Function: 
(R1) : (OP2) 
Description: 
The compare half-word instruction compares algebraically the contents of the register specified by R1 to the 
contents of the half word specified by OP2. 





Operational Conditions: 
1. The OP2 address should be defined at a half-word boundary. 


2. The condition code is set as follows: 





0 (R1) = (OP2) 
1 (R1) < (OP2) 
2 (R1) > (OP2) 


Examples: 






A OPERATION A OPERAND A COMMENTS 





113.1261 14) 1 7 1 1 [COMP LIE TE, SIPECI FECA TION 


UAGRINRT » ii [RELATIVE ADDRESS | pty J 
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3.3.3.2. Compare Logical Character 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE |HEXADECIMAL) OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 
(OP1) : 12 
Description: 


The compare logical immediate instruction compares logically the contents of the byte specified by OP1 to the 
immediate operand, !2. 


Operational Conditions: 
1. The operands are compared without regard to sign. 
2. The condition code is set as: 
0 (OP1) =12 
1 (OP1) <12 
2 (OP1) > 12 


Examples: 











A OPERATION A OPERAND COMMENTS 
0 






23,0991 X09, 1 LCOMP LIE TE, SIPECUFILCAT ION, | 
CHER ABLE, X09)", (RELATIVE, AODRESIS | ty iy 








INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HEXADECIMAL OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 


(OP1) : (OP2) 
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Description: 


The compare logical character instruction performs an absolute binary comparison of the contents of the 
address specified by OP1 of the contents of the address specified by OP1 to the contents of the address 
specified by OP2. The number of bytes to be compared is determined by the length specification in the first 
operand; the maximum is 256 bytes. 


Operational Conditions: 


1. Execution of the instruction is terminated and the condition code is changed after the first inequality is 
found. 
2. The condition code is set as: 
0 (OP1) = (OP2) 
1 (OP1) < (OP2) 
2 (OP1) > (OP2) 
Examples: 


LABEL A OPERATION A OPERAND A COMMENTS 
10 16 


Li ¢ +! V0. £151) 17121668.) ) JE,OMPLIE TE, SIPE CI FCAT ION, | | 
Clu € 1 W519i. 7 2 18), IMPLIED, BEING TH fh 
QU: AO | 1.0 TIRAP, | IREGATIIYE, AOD RESIS. a a ha a 


fee 
: QUAD. [TRAP POMP bt iC tT, LJ EN, GT HI (AND, JAD, OR, E/S,S, 1. 
fees | | 














INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE =| HEXADECIMAL| OBJECT 


TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 
CODE CODE LENGTH 





Function: 





(OP1) : (OP2) 


Description: 





The compare packed decimal instruction algebraically compares the contents of the bytes specified by OP1 to 
the bytes specified by OP2; the maximum number of bytes is 16. Both OP1 and OP2 should contain packed 
decimal fields. 





























7508 Rev. 3 


UP.NUMBER 


UNIVAC 9200/9200 11/9300/9300 !I1 SYSTEMS 






PAGE REVISION 


Operational Conditions: 
1. The operands are processed from right to left. 


2. ‘If OP1 is larger than OP2, the remaining digits of OP1 are compared to zero. If OP2 is larger than OP1, 
the remaining digits of OP2 are ignored. 


3. A sign is assumed in the four rightmost bits of the least significant byte of both operands and is 
considered in the comparison. 


4. The condition code is set as: 
0 (OP1) = (OP2) 
1 (OP1) < (OP2) 
2 (OP1) > (OP2) 


Examples: 








OPERAND COMMENTS 


































6 ¢ 


lar iI) Le 17,8 


aa Daa ee a Pb NED, ri LEM GTR. to th 


PiRi Oi Vid a TREATY EE SAID DRE SIS: sa tt bi 


3.3.3.5. Test Under Mask 


MNEMONIC HEXADECIMAL| OBJECT 
INSTRUCTION SYMBOLIC SOURCE CODE 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 
test (OP1) : 12 


Description: 
The test under mask instruction tests the bits in the byte specified by OP1, using !2 as a mask for the test. Bit 
positions not to be tested are indicated by 0 bits in the mask; 1 bits indicate bit positions to be tested. 


Operational Conditions: 

1. The condition code is set as: 
No match 
Partial match 


Not used 
Full match 


WN oo 


3-31 
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Examples: 






COMMENTS 









OPERAND 





BOC U4 eX oF CO UM PULL EL TIE, (SIPLE CIFIC A TALON, 
PAMVEAVAL XR i a IRIE LATIN VE) VAD DRE S1S) 7 py | 











3.3.4. Data Manipulation Instructions 


The data manipulation instructions edit, translate, or change formats of data stored in main storage. The instructions 


include: 
Mnemonic Function Format 
ED Edit SS1 
PACK Pack $S2 
TR Translate SS1 
UNPK Unpack $S2 


Of the data manipulation instructions, only the edit instruction sets the condition code. Operands are processed 
from left to right in the translate and edit instructions and from right to left in the pack and unpack instructions. 


The instructions are explained separately in the text and are accompanied by notes on their limitations and 
operands. 


3.3.4.1. Edit 











INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE ‘| HEXADECIMAL OBJECT i 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 3 
CODE CODE LENGTH : 
D4(L,B1),D2(B2) oo 
Function: 
(OP2) > OP1 
Description: . 


Execution of the edit instruction transfers data from the bytes specified by OP2 to the bytes specified by OP1, 
changing the data format from packed decimal to unpacked decimal, inserting zone bits and editing symbols, 
and suppressing leading zeros. This editing process is controlled by the editing mask in OP1, which is overlaid 
by execution of the instruction. OP2 should be a packed decimal field and OP1 should contain the editing 


mask. 
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Operational Conditions: 


1. The following pertains to the 9200 system optional software version of this instruction; see also card 
utility programs programmer reference manual, UP-4120. 


a The software edit function is provided by a fixed, closed subroutine in relocatable object code. It 
requires approximately 375 bytes of main storage and must be linked to the problem program. To 
make this linking possible, the following source code must be inserted in the program: 






LABEL OPERAND 





A OPERATION A 
10 1 





e The source code necessary to accomplish the instruction is: 








a Other than the above, the software edit instruction is identical in operation to the hardware 
version. 


2. The operands are processed from left to right. 
3. The contents of OP1, after execution of the instruction, are dependent upon: 
Fill character 
Digit select byte (DSB) 
Significant start byte (SSB) 
Field separator byte (FSB) 
Editing symbols 
Sign of OP2 
a. Fill character 
The leftmost byte of OP1 contains the fill character, which can be any alphanumeric or special 
character. It is used to replace bytes in the OP1 editing mask. The first byte always remains as the 
fill character. ~ 
The fill character is substituted for: 


s Leading zeros — any zero in OP2 not preceded by a significant nonzero digit. 


a Leading editing symbols — any byte containing one of the available characters specified for 
editing in the OP1 mask not preceded by a significant digit. 


a Field separator byte —.a special byte that acts as a separator in multiple field editing. 
a Rightmost bytes of OP1 when the sign of OP2 is positive. 


The most commonly used fill characters are the asterisk and the blank. 





\ 


Gi 
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Digit select byte (DSB) 


The digit select byte, a hexadecimal 20, is replaced by digits from OP2 or by the fill character. The 
DSB is replaced by a digit from OP2 if that digit is significant or was preceded by a significant 
digit. The fill character replaces the DSB in all other situations. 


Significant start byte (SSB) 


By using a significant start byte, hexadecimal! 21, in OP1, the presence of a significant digit in OP2 
is simulated. The suppression of leading zeros and fill characters ceases with the byte immediately 
following the SSB. 


Field separator byte (FSB) 


The field separator byte, a hexadecimal 22, is used in the OP1 mask to separate fields in 
multiple-field editing. The FSB always is reptaced by the fill character, and all leading zeros or 
editing symbols following the FSB also are replaced by the fill character. This procedure continues 
until a significant digit is processed or an SSB is specified in OP1 just as if this were the beginning 
of a new editing instruction. 


Editing symbols 


Any alphanumeric or special character may be specified as an editing symbol in OP1. These 
symbols never are replaced by a digit from OP2, but are replaced by the fill character before a 
significant digit has been processed. 


Sign of OP2 


If any byte of OP2 contains a 4-bit digit with a value greater than eleven (X‘0B’), it is recognized 
as a sign. If the sign of OP2 is positive, any editing symbols in the mask at the end of OP1, or 
between the last DSB and an FSB, are replaced by the fill character. If the sign of OP2 is negative, 
these editing symbols remain in OP1. 


Zone bits are inserted in OP1 when digit bits from OP2 overlay the editing mask. The bits inserted are 


1111 in the EBCDIC mode, and 0101 in the ASCII mode. 


oI 


An example of the use of the edit instruction is: 


LABEL 6 OPERATION 6 OPERAND A) 


_ 


2/0, P,T,U 


>» Ww 


5{|A,L PA 


on 


oo oO Ns 


16 
Tx. t.6," 04" ; 
X14," 01" a l 
X," 4,0 ,2{0,2,0 ,6,B]2,0,2,1,2|0,4,B,2,0 |2,0,C,3,D)9,’ 


i=] 
a 1a {1a 


0.P,0.N,, |E,0,M,K 
0,P,0,N,, (0,P,T,U ere oe | fe 








P\U,T P,R,IEN,T),,0,P,0,N | { ria | 
(BSc me Soe st al es bs ee Ba WR Wer en Oey AN aR el OR eT 
B,C 1,5,,,A,L)P,A 


Ee ee es Ba eee 
eee ree 
< 
a 
Ce ae Te 
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Line 1. A work area, OPON, is defined and binary 0’s are used to fill it. It is the same length as the 
editing mask. Nee 


Line 2. A work area, OPTU, is defined and filled with binary O0’s. The packed number to be edited 
is moved here. 


Line 3. The editing mask, EDMK, is defined. 
Line 4. Processing takes place; the number is generated. 
Line 5. The editing mask is moved to preserve it. 


Line 6. If OPTU contains a value representing —106071 and the desired output format is xx,xxx.xx 
if positive and xx,xxx.xxCR if negative, the operation of the edit instruction is: 





OP2 
OP1 
. j i 
opt [40 [40 | 1] 66] Fo] ro] Fo] a8] Fr] F1{ cs ps) 
a. The fill character remains; this first byte never is replaced. 
b. The corresponding digit in OP2 is a leading zero; the fill character replaces this DSB. 
c. Thecorresponding digit in OP2 is significant; it replaces the DSB. 
d. This editing symbol, a comma, remains in OP1 because it was preceded by a significant digit. 
e. This DSB is replaced by the digit from OP2 because it was preceded by a significant digit. 
f. This SSB is replaced by the significant digit from OP2. It is placed in the mask to ensure that the 
next digits are placed in OP1 even if they are leading zeros. 
g. This DSB is replaced because it is preceded by a significant digit and because it is preceded by an 
SSB; either is sufficient. 
h. This editing symbol, a period or decimal point, remains in OP1 because it was preceded by a sf 


significant digit or an SSB. 
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a. The fill character replaces the first six bytes of OP1 because no significant digit was processed in 


b. The SSB is replaced by the fill character, but the next byte is replaced by the corresponding digit 


c. This DSB is replaced from the OP2 digits because it was preceded by an SSB. 
d. _—‘ This editing symbol remains because of the previous SSB. 


e@, This DSB is replaced by the significant digit from OP2. 
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i. This DSB is replaced by the significant digit from OP2. 





j. This DSB is replaced by the significant digit from OP2. 


k. These editing symbols, C and R (any number of the available characters could have been 
specified), remain in OP1 because the sign of OP2, a hexadecimal D, was negative. 


The result of the operation stored in OP1 is 1,060.71CR. 
Line 7. The result of the editing process is then moved before printing. 
Line 8. More processing occurs and another number is derived for editing. 


Line 9. An unconditional branch back to the editing path is specified. 





Line 5. The mask is moved again. 


SiS alpen 


Line 6. If OPTU contains a value representing .71, and the output format is the same, the operation 
of the instruction is: 








OP2 
OP 1 
| 
is 
opt [40] 4040 | a0] co] co fro fee [rr] ex] eo || 


OP2. . 


from OP2. 
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f. This DSB is replaced by the significant digit from OP2. 


g. These editing symbols are replaced by the fill character because the sign of OP2, a hexadecimal F, 
is positive. 


The result of the operation sorted in OP1 is 0.71. 
6. ‘The edit instruction sets the condition code as: 
0 The portion of OP2 following the last FSB is zero, or the last byte of OP1 is an FSB. 
1 The portion of OP2 following the last FSB is not zero and is placed in OP1. 
2 The portion of OP2 following the last FSB is not zero and is replaced by the fill character in OP1. 


The condition code settings are useful in multiple-field editing, but do not reflect the contents of any 
part of OP2 that precedes the last FSB in the editing mask. 


Examples: 
















A OPERATION A OPERAND 
10 16 





COMMENTS 





VOC 2V 14s) 18:39 dt | CO MIP LE, TE] SPE CU FNC AT FON | 
WS iris, BiFlC9y yy | PM PIL IED, JLAENGTIH ba 
O PON (121) Fi O.2, 1 RELA TH VE A DORIES SS, | ta. 
LFW Di2s to MPL ert Tl UL EN GITIH; (AND, ,A,D,O/R, E,S,S,_ 


























3.3.4.2. Pack 


MNEMONIC HEXADECIMAL| OBJECT 
INSTRUCTION SYMBOLIC SOURCE CODE 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 
(OP2) > OP1 
Description: 


. Execution of the pack instruction transfers the contents of the bytes specified by OP2 to the bytes specified 
by OP1, altering the data format from unpacked decimal to packed decimal. 


Operational conditions: 


1. Operands are processed from right to left, as: 





OP2 (unpacked decimal) 
OP1 (packed decimal) 
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where: 
Z = zone bits 
D = digit bits 
S = sign bits 
Note that the first byte sign and digit positions are reversed by execution of the instruction. 
2. If OP1 is larger than OP2, the remaining digits of OP1 are zero filled; if OP2 is larger than OP1, the 
excess digits of OP2 are ignored. 
3. The maximum length of operands is 16 bytes. 
4. — Execution of the instruction does not change the condition code setting. 
Examples: 
OPERAND COMMENTS 
OC 3, Bid V9 1,5, 9D; | COMPLETE, SPECIFICATION | 
BL ru 19) y ty GEM PIL TED, JLLEN.G TIM | | pb a 
B rt RB LIATUVE: IADDRIE SS) pba a 
a LM PUR CT) UL EWN Gi T.H, .AIN]D, A, D,O/R,E.8;S; 
- 


Na, 3.3.4.3. Translate 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HE XADECIMAL OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





D1(L,B1),D2(B2) 6 BYTES 





Function: 
Translate (OP1) using (OP2) > OP1 


Description: 
Execution of the translate instruction replaces the bytes of OP1 with the contents of the translation table at 
OP2. The binary value of each OP1 byte is used as the relative address of its replacement in the translation 
table. 





Operational conditions: 
1. Translation of OP1 occurs one byte at a time in a left-to-right sequence. 


2. The capacity of the translate table is 256 characters. 





4 3. The length specified in OP1 determines the number of bytes translated. 
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OP2 is not changed by execution of the instruction. 


YAH 
5. Execution of the instruction does not change the condition code setting. 
6. The instruction operates as: 
The user has a message in his program that is in his own code, which, for this example, consists of a 
simple substitution of a number for a letter, 1 for A, 2 for B, ..., 26 for Z, and zero for blank. If the 
message is to be printed, the characters must be in EBCDIC code. 
The programmer sets up a table and stores it in main storage; in this case, it is stored at location 6000 
and labeled TBLE. The table is 27 bytes long, but could be a maximum of 256 bytes. TBLE contains the 
hexadecimal values: 
TBLE (location 6000) : 40 
TBLE +1 : C1 
TBLE +2 : C2 
TBLE +26 : EQ 
VAY 


In other words, TBLE contains the equivalent of the EBCDIC code for the alphabet. 
‘The message in the program that must be translated is, in hexadecimal: 

OD, 05, 13, 13, 01,07, 05, 00, 09, 13, 00, 14, 12, 01, 

OE, 13, OC, 01, 14, 05, 04 
The message is labeled NOTE and is 21 bytes long. 


The instruction used to translate NOTE is: 


LABEL A CERT OPERAND A 


Tae 1S Ue 21) 1. TIBLE 
Ieaihageip (test ltl iaac §.4che poo ders se tee tera Pe te 


In the operation, the binary value of each byte is used to address relatively its replacement in the 
translation table. 











The value of the first byte of NOTE is 13 (because OD in hexadecimal equals 13 in decimal); it is 
replaced by the thirteenth byte of TBLE (location 6000 + 13). TBLE + 13 contains the value 1101 
0100, an EBCDIC M. That value replaces the first byte of NOTE. A 
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The operation is the same for the second byte. Its value is 05, or 5; it is replaced by the value at 
Oe location 6005, an EBCDIC E. Each byte of NOTE is replaced in that manner for the number of 
bytes specified by the length of the first operand in the instruction. 


Examples: 






COMMENTS 





A OPERATION A OPERAND 
10 





TIR, yt 34540.2,01, 9) TEC VV) | COMPLETE SPEC! FE CATION 7 
TR, i tf SC I MST MP EE, SENG TA 
TR, ps | INO TEM (20,9), TBE, | |) RELATIVE; ADO RIES S |) ta | 
TIRs a NOTE ITB EG Ly ty MPIC tT) LENG) TH, ANID, (ADDRESS 























3.3.4.4. Unpack 





INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HE XADECIMAL OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 
CODE CODE LENGTH 
UNPK D4(L1,By),D2(L2,B2) 6 BYTES 
Function: 
f- 
QQ (OP2) > OP1 
Description: 


Execution of the unpack instruction transfers the contents of the bytes specified by OP2 to the bytes specified 
by OP1, altering the data format from packed decimal to unpacked decimal. 


Operational conditions: 


1. | Operands are processed from right to left, as: 1 by fe 


pop ap 


OP2 (packed decimal!) 





OP1 (unpacked decimal) 


where: 


Z = zone bits 
D = digit bits 
S = sign bits 


A sign is assumed to be in the rightmost byte of OP2 and the byte sign and digit positions are reversed 
by execution of the instruction. 


2. The zone bits of OP1 are added to the digit bits from OP2. Either 1111, an EBCDIC zone pattern, or 
WH 0101, an ASCII zone pattern, is added. 















7508 Rev. 3 
UP-NUMBER 


UNIVAC 9200/9200 11/9300/9300 Il SYSTEMS 






PAGE 






PAGE REVISION 





3. If OP1 is larger than OP2, the remaining bits of OP1 are filled with the unpacked zero character (X‘FO’ 
EBCDIC). If OP2 is larger than OP1, the excess bits of OP2 are ignored. Ne 


4. Maximum length of operands is 16 bytes. 


5. Execution of the instruction does not change the condition code setting. 

















Examples 
LABEL A baer er OPERAND A COMMENTS 
10 
eee 381,011 5.) 112.806) 1,5), [COMPLE TE, SPECI FICATION op 
BBC US ABC US i EM PEED EING TA | dd 
DF LDC) 1,0,) ., NUM L016), IREL ATIVE, ADORE SS ota laa 
DRL DN UME LD EMPL CNT, LENGTH) (AND, |AD DRESS, | 








3.3.5. Data Transfer Instructions 


The data transfer instructions move data between storage locations and registers, other storage locations, or 
immediate operands. The data transfer instructions include: 


Mnemonic Function Format 

LH Load half word RX 

MVC Move characters SS1 CS 
MVI Move immediate data Sl 

MVN Move numerics $s1 

MVO Move with offset $S2 

STH Store half word RX 


The formats of the data transfer instructions vary with the function of the instruction. The instructions do not 
change the condition code setting, and operands are processed from left to right on all instructions except the move 
with offset. 


The instructions are explained separately in the text and are accompanied by notes on their limitations and 
operations. 


3.3.5.1. Load Half Word 


MNEMONIC HEXADECIMAL| OBJECT 
INSTRUCTION SYMBOLIC SOURCE CODE 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 
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Description: 


The load half-word instruction transfers the contents of the half word specified by OP2 to the register 
specified by R1. 


Operational conditions: 


1. The OP2 address should be defined at a half-word boundary. 





2. Execution of the instruction does not change the condition code setting. 


Examples: 











OPERAND COMMENTS 


16 






BUM MS) a de COMP LIE, TE, SIP EC FIC ATHLON, | yt 
AB POSIT be REA VE, GAID DRESS, ou ba a doa, 








3.3.5.2. Move Characters 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HE XADECIMAL OBJECT 
T VEE OPERATION GPERAND FORNAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 
(OP2) > OP1 

Description: 
Execution of the move characters instruction transfers data from the bytes of main storage specified by OP2 to 
the address specified by OP1. The number of bytes transferred is determined by the length specification in 
OP1. The maximum number of bytes that can be moved is 256. 

Operational conditions: 
1. Characters are moved unaltered and OP2 is unaltered by the instruction. : 


2. Execution of the instruction does not change the condition code setting. 


Examples: 








21510801 9) M4 CUS) os LE OM P LIE TE, SIP EC UFC ATION Go J 
TAG. VNC Ss a bh a Ph ED, LENG TA) | bh 
FUSYARIG8.0) iG ARO, | ou  IREL ATIVE AID ORE SS, ) tb. 
FU SYR GAR DIT Ot UMP ECT, LIEN,G. TH) ALND, (AOD, REISS, 
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3.3.5.3. Move immediate Data 


HE XADECIMAL OBJECT 


MNEMONIC 

INSTRUCTION SYMBOLIC SOURCE CODE 

TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 
CODE CODE LENGTH 






Function: 
12> OP1 
Description: 


The move immediate data instruction transfers the immediate data, 12, to the byte specified by the OP1 address. 


Operational conditions: 


Execution of the instruction does not change the condition code setting. 


Examples: 








COMMENTS 





C,0.M,P,L/E.T,E, S)P,E.C,1,F/I,C,A,T,1 JON, 
Re Rat RELATIVE, A/D,D.RES/S 
a Wee eet se ar st Or 


3.3.5.4. Move Numerics 





INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HEXADECIMAL OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 
CODE CODE LENGTH 
Function: : : 
(OP2) > OP1 
Description: 


The move numeric instruction transfers the numeric bits from the bytes of data specified by OP2 to the 
numeric bits of the bytes specified by OP1. The number of bytes affected by the instruction is dependent on 
the length specification of OP1; the maximum is 256. 






3-43 
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Operational conditions: 





1. The zone bits of the bytes in OP1 are unaffected by the instruction. 
2. Execution of the instruction does not change the condition code setting. 


3. The instruction functions as: q 
1 byte 


a 
OP1 (before execution) 
2 ae ee 





OP2 





OP1 (after execution) 


After execution of the instruction, the zone bits of OP1 are unaltered and the digit bits are overlaid by 
the digit bits from OP2. 





Examples: 


LABEL A OPERATION A OPERAND A COMMENTS 
10 16 














BCI TO) VTC 2d COMPLI E TE, SIPLEC FM GATNIOIN, Go doi: 
BC NOP MV 2d eb MP ED, LU EINGG TA, | 


GOT ZEN ta IRIEL ATIVE ADDRESS i daa. 
0,¢,7,, ,Z/E,N MP LUCH T, CEN GT AH AND, AO DRESS, | 





Woo ta ot MPL 








3.3.5.5. Move With Offset 
































INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HE XADECIMAL OBJECT 
VEE OPERATION GPERAND FORMAT OPERATION | INSTRUCTION 
CODE CODE LENGTH 
D1(L1,B1),D2(L2,B2) Fl 6 BYTES 
Function: 
(OP2) > OP1 
Description: 








Execution of the move with offset instruction transfers data from the bytes specified by OP2 to the bytes 
specified by OP1, moving the data four bits to the left as it is processed. 


Operational conditions: 


1. The operands are processed from right to left. 





2. The first four bits of OP1, the least significant or rightmost bits, always remain unchanged. 
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If OP1 is larger than OP2, the remaining leftmost positions of OP1 are zero filled. OP1 must be at least 
one byte larger than OP2 to avoid truncation of the data on the left. If OP2 is larger than OP1, however, 
the excess leftmost positions of OP2 are ignored. 

4. |The maximum length of operands is 16 bytes. 


5. Execution of the instruction does not change the condition code setting. 


6.  Theinstruction functions as: 

































LABEL A OPERATION A OPERAND 
1 10 16 
Haft | BATA ey 2), DALTAITW,O(3)) 
Perera & ave teeraetres 





results in: 





OP2 


lost 


Pet | Iwi, sf fovata31.30)u, DIATLALE,OLURY 2) os 


results in: 


OP2 


inserted 


OP1 





results in: 


OP2 


OP1 





where: 


D1,...,D6 = digits occupying four bits of the byte. 
x = the original contents of these positions. 
0 = zero fill of the MVO instruction. 
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Examples: 
















A OPERATION A OPERAND 
10 16 





COMMENTS 


\C,OMIP LE TE) SPECIFICATION, | yy. 
Lads tld Old Wid ve SUMP LIED, JEN GTB Ca tia a bias 
M0,0.G.( 11,61). (SIYINI TM, | REL IA TIVE! AD ORES S, i daa a 
MOOG) iS YNT A a ta ty MPL GET) LL E,N,G) TH, ,ANjD, A, OD/RE, SS, 


: 
3 
e 
E 
E 


























3.3.5.6. Store Half Word 





TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 


(R1) > OP2 


Description: 





The store half-word instruction transfers the contents of the register specified by R1 to the half word in main 
storage specified by the OP2 address. 


Operational conditions: 


1. The OP2 address should be defined at a half-word boundary. 





2. Execution of the instruction does not change the condition code setting. 


Examples: 









L, .C,0,MjP,L,E,T,E; |S.P,€,C)1,F1,C, AT, 1,0,N,_ 


1,5, ,USJE FUL, |» RELATIVE; AD DRESS, » fyi 











SIT Hi 








3.3.6. Display Instruction 


The halt and proceed instruction is a display instruction; its execution stops the processor and displays a selected 
series of digits in the halt/display indicators of the console. 





Mnemonic Function Format 





HPR Halt and proceed Sl 
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3.3.6.1. Halt and Proceed 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE | HEXADECIMAL) = OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 
display OP1 

Description: 
Execution of the halt and proceed instruction stops the processor and causes a display in the halt/display 
indicator on the console. If the most significant bit of OP1 is 0, the display is the 16 bits of OP1, as specified 
in the instruction. If the most significant bit of OP1 is 1, the display consists of the contents of the register 
specified by the leftmost 4 bits of OP1, plus the rightmost twelve bits of OP1. 


Operational conditions: 


1. 12 of the St format need not be specified with this instruction. 





2. Thenextinstruction in sequence is executed by pressing START. 


3. Execution of the instruction does not change the condition code setting. 





Examples: 





LABEL A OPERATION A OPERAND A 





DI ,S/PLJA,Y,S, ,3)/F,F,F, | 
2:.4¢,8) (4... 1) (DIS PLAYS, ADDRESS, , ty 





















3.3.7. Input/Output Instructions 


T he input/output instructions are a pair of instructions that test the status of an input/output device or initiate an 
input/output function. The instructions are: 


« 


Mnemonic Function Format 


TIO Test input/output status SI 
XIOF Execute input/output function SI 


The instructions are explained separately in the text and are accompanied by notes on their limitations and 
operations. 
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3.3.7.1. Test Input/Output Status 





INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CopE | HEXADECIMAL| OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 
CODE CODE LENGTH 
Function: 
status > OP1 
Description: 


Execution of the test input/output status instruction tests the status of the device specified by 12 and sets the 
condition code; the status of the device tested is stored in the byte specified by the OP1 address. 





Operational conditions: 


1. The instruction clears the device status for the device tested if the device is not busy. If the device is 
busy, the status is not reset. 





2. The interrupt request is part of the device status and is cleared by the instruction. 


3. The condition code is set as: 





Device is available. a 
Valid status. 2 
Busy. : 
Rejected. 





WN oOo 





Examples: 









OPERAND 







COMMEN’ 









200 154) i X"O15s' 1 ys LC OM PLE, TIE, SPEC I FIN C AT IOLN, 
EVEN IX 05%) 1 TREE ATIVE, VAIDD RIE SIS, yu da. 

















INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE | HEXADECIMAL OBJECT 


TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 
CODE CODE LENGTH 
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Function: 






execute OP1 






Description: 






The execute input/output function instruction initiates the function defined by the specification in OP1 on 
the device specified by OP2. 






Operational conditions: 






1. The XIOF instruction uses information characteristic to each peripheral input/output device. The 
necessary information can be found in the central processor unit programmers reference manual, 
UP-7546. 






2. The buffer control word associated with the specified device must be loaded with the proper control 
information for this device before the XIOF instruction is executed. 






3. If the instruction is executed with interrupt inhibited, the status or device address is never stored 
automatically. The procedure to be followed is the same as if I/O operations are performed in the 1/O 
mode. In particular, the interrupt pending bit is set when the I/O operation is completed. 







4. The function specification in OP1 defines the type of operation to be initiated. 






5. For the dedicated I/O devices, bit 27 (the H bit) is reserved to inhibit generation of al! interrupt requests 
when the operation ends. In this case, the interrupt pending bit is set at the completion of the 1/O 
Operation initiated by the instruction. 







6. The condition code is set as: 






O Function accepted. 

1 Status pending. 

2 Busy. 

3 Function rejected, invalid device number. 







Example: 


OPERAND 











3.3.8. Logical Instructions 


The logical instructions form the logical products or sums of data in storage, using other data in storage or 
immediate operands. The instructions include: 





Mnemonic Function Format 
NC AND characters SSi 

NI AND immediate data Sl 

oc OR characters ssi 


Ol OR immediate data Sl 
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The formats of the logical instructions vary with the function of the instruction. The instructions set the condition 
code and the result is stored in the first operand with each logical instruction. 








The instructions are explained separately in the text and are accompanied by notes on operations and limitations. 


3.3.8.1. AND Characters 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HEXADECIMAL OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 


(OP1) EM (OP2)~>OP1 





Description: 
Execution of the AND characters instruction forms the logical product of the bytes specified by OP1 and OP2, 
and stores the product in OP1. The number of bytes affected by the instruction is determined by the length 


specification in OP1; the maximum is 256. 


Operational conditions: 





1. Each 1 bit in OP1 matched by a 1 bit in the same relative position in OP2 produces a 1 bit in OP1; in . Z 
any other case, a 0 bit results in OP1. 


2. The condition code is set as: 


O Result is zero; no 1 bits in the product. 
1 Result is not zero; one or more 1 bits in the product. 





Examples: 






COMMENTS 






OPERAND 













2,5,(,1,914),:8.) 120.0141), . COMPLETE, (SPEC UF ICA TION, | 

SiC BU BO n4 de a Lora GML PLE ED! GL EWNIGIT A obo a ad aad 
. 

NUE VIAL, 1,9 14 d. Let $,! NI 1S. =e REIL ATI Y JE, ,A,D,DIR; E,s,S 4a ! ded dd le hed db od i 


NWE VIAL SUNS MPL LC iT, LENGTH, ,AIN,D, ,A,D{D,R\E;S Sj 
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3.3.8.2. AND Immediate Data 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HE XADECIMAL OBJECT 


CODE CODE LENGTH 








Function: 
(OP1) fH I2>OP1 


Description: 





Execution of the AND immediate data instruction forms the logical product of 12 and the byte specified by 
OP1. The product is stored in OP1. 


Operational conditions: 


1. Each 1 bit in OP1 matched by a 1 bit in the same relative position in 12 produces a 1 bit in OP1; in any 
other case, a 0 bit results in OP1. 


2. The condition code is set as: 


O Result is zero; no 1 bits in the product. 
1 Result is not zero; one or more 1 bits in the product. 


Examples: 






OPERAND COMMENTS 







"COMPLETE SPEC LEI CATION, | oj, 






28 C V5) Xr" 810. 
BRT HK 801 RE ATIGViE ADORESS: 2... 502. 0bnG.. 





3.3.8.3. OR Characters 





INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE =| HEXADECIMAL OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 


(OP1) (OP2) > OP1 
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Description: 


Execution of the OR characters instruction forms the logical sum of the bytes specified by OP1 and OP2 and 
stores the sum in OP1. 


Operational conditions: 


All 1 bits of OP2 are superimposed on OP1; 0 bits in OP2 do not affect OP1. The maximum number of bytes 
allowed is 256. 


The condition code is set as: 


O Result is zero; no 1 bits in the sum, 
1 Result is not zero; all or some 1 bits in the sum. 


Examples: 






COMMENTS 












OPERAND 








AV 7 15011210 8) be 4 C9) COMPLE TE) SPEC FE CATION | 
1 il 154 da (Bidet 4 19 ) Pee Pods. aia! iM,PjL,! ,£,D, [LENG TH, bos i ] 1 | ar eee I. Bare eae acy 
Jer SMF 12,0) [TEE | RELATIVE; ADORIES S yb 


LiSMF (TEE, 1 be tM PIE Ct Ty LEN G]T.H, WAN)D, | AD DIRE, SS, 














, 3.3.8.4. OR Immediate Data 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CopDE | HEXADECIMAL| OBJECT 
TYPE OPERATION OPERAND- FORMA OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 


(OP1) ff I2>O0P1 
Description: 


Execution of the OR immediate data instruction forms the logical sum of 12 and the byte specified by OP1 
and stores the sum in OP1. 


Operational conditions: 
All 1 bits of [2 are superimposed on OP1; 0 bits in 12 do not affect OP1. 
The condition code is set as follows: 


0 Result is zero; no 1 bits in the sum. 
1 Result is not zero; all or some 1 bits in the sum. 
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Pe ce ea 


Examples: 






A OPERATION A OPERAND 
10 1 


6 








125.0111 210), 8) L409) | COMPLETE; SPEC FICATION | 
1 u 5iC ue 18rd 4C 19d ae el. a tM Py kT ED, (L,E,N.G,T{H, Pk 2 | bob dk Ben pe ean) coer ¢ I 
LiSMFC11,2,0) ITE 4b RELATIVE) APP RIES S ype tai iid 
LSM (TEE, pt | MPI LN Ct T] LENGTH, ALND, ,A0,0)R,E, SS, | 




















3.3.9. Supervisor Instructions 


The supervisor instructions execution affects the contents of the lower bytes of main storage. The instructions store 
or modify one of the program state control words or communicate between operator and problem program. The 
supervisor instructions are: 





Mnemonic Function Format 
LPSC Load program state control Sl 
SPSC Store program state control Sl 
SRC Supervisor request call St 


While there are technically no ‘‘privileged” instructions on the 9200/9300 series systems, the use of the LPSC/SPSC 
instructions is usually reserved by software convention to the operating system. 


The instructions are explained separately in the text and are accompanied by notes on their limitations and 
operations. 





3.3.9.1. Load Program State Control 





INSTRUCTION | opeRation | SYMBOLIC SOURCE CODE | OPERATION. | INSTRUCTION 
CODE CODE LENGTH 
Ps [ee [neon [| sores | 
Function: 
(OP1) > PSC 
Description: 


Execution of the load program state control instruction may replace or modify the specified program state 
control. word in low-order main storage. The word specified by the OP1 address, under the control of the bits 
of the immediate operand 12, is stored at the PSC location. 
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Operational conditions: 
, ie 
a, 1. The storage area specified by OP1 must be defined on a half-word boundary. 


2. The functions of the OP2 bits are: 


1 byte 
oP2 [x [x] x]x]x]x[o[o] 
0 7 Bits 
where: 
x 





May be either a 1 bit or a O bit, depending on the programmer's requirements. 





Bits 0,1 control the loading of the PSC word and the ASCII bit. 





0,1 
00 PSC word remains unchanged. 
01 ~—_ Load full PSC word stored at the OP1 address. 
10 Set ASCII bit in PSC word to zero. 
11. Set ASCH! bit in PSC word to one. 
Bit 2 specifies which PSC is to be affected by the instruction. 


2 


C) 


0 Load processor PSC. 
1 Load input/output PSC. 





* Bit 3 specifies which PSC word controls the next instruction executed. 





3 


0 Processor PSC has control. 
1 Input/output PSC has control. 


Bits 4,5 control the alter function. 
45 
00 = Alter state remains unchanged. 
01 ~—s&Restriction to location 4 is removed. 


10 = Alter is restricted to location 4. 
11. Result is unpredictable. 





Bits 6, 7 are always O. 





Examples: 


OPERAND A COMMENT! 





218.C. 141) Xr 4iO COM PLETE, SPIE CUFICA TION, | | 
pus |i yf IL IP SiG CHIN, G IX) 9,8") 1 RIEL A TUVE, ADID,RES S! ) ba 
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3.3.9.2. Store Program State Control 
























INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE =| HEXADECIMAL OBJECT 
ayPE OPERATION GPEREND EORAAT OPERATION | INSTRUCTION 





CODE CODE LENGTH 


Function: 
PSC > OP1 
Description: 


Execution of the store program state control instruction moves the specified program state control word to 
the address specified by OP1. 


Operational conditions: 
1. The storage area specified by OP1 must be defined on a half-word boundary. 


2. 12, the immediate operand, controls the PSC that is stored; the third bit of the byte selects the PSC 
word: 


1 byte 


se, 
or2 o[o[x]ofofofofo| 
0 7 bits 





where: 


0 = bits not used. 
x = bit used to select the PSC word: 


QO Stores the processor PSC; 
1 Stores the input/output PSC. 





Examples: 






OPERAND 





COMMEN’ 





A OPERATION A 
10 









WW), X20," C;0O,M,P,L,E| TE S,PjJE. CIF NIC AT IOIN 
CHAN G(X’ ,0,0") ) RELATIVE, ADDRESS: tay 


1 
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3.3.9.3. Supervisor Request Call 


INSTRUCTION | MNEMONIC SYMBOLIC SOURCE CODE HE XADECIMAL OBJECT 
TYPE OPERATION OPERAND FORMAT OPERATION | INSTRUCTION 


CODE CODE LENGTH 





Function: 


12> SRC 


Description: 


Execution of the supervisor request call instruction stores the immediate operand, 12, in the SRC portion of 
the I/O PSC word and sets the interrupt request. 


Operational conditions: 


1. 


2. 


OP1 is ignored. 


Interrupt occurs immediately when the processor is under control of the processor PSC word, but is 
stored when input/output PSC is in control. 


When the interrupt request is accepted, no device address or status is stored. 


An 1/O operation can be completed when an SRC instruction is executed in the processor mode. The 
device address and status are stored, making them available when the interrupt occurs. 


Example: 








A OPERATION A 
10 


OPERAND A 


3-55 
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4. Assembler Directives 








4.1. DIRECTIVES 


In addition to the representation of machine instructions, constants, and storage, the SPERRY UNIVAC 9200/9300 
Series Tape/Disc Assembler language includes several assembler directives. These are instructions to the assembler to 
perform certain functions; they afford the user of the assembler language control of the operation of the assembler. 








The assembler directives, grouped by function, are: 
Symbol definition 


EQU 





Assembler control 
START 
END 
ORG 
LTORG 
Base register assignment 
USING 
DROP 
Program linking and sectioning : 
CSECT 


DSECT 





COM 


ENTRY 


EXTRN 
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Listing control 
PRINT 
SPACE 
EJECT 
TITLE 

Input control 


ISEQ 


Assembler directives EQU, END, ORG, USING, DROP, ENTRY, and EXTRN may use one or more symbols in the 
operand field, and, with the exception of ENTRY, EXTRN, USING, and DROP, the symbols must have appeared in 
the label field of a previous statement. 





4.2. SYMBOL DEFINITION 
EQU — Equate 


The value and length attribute of asymbo!l may be defined explicitly. The statement format is: 





A OPERATION A OPERAND 






symbol ezl,e9] 
where: 


e, and e, are expressions. 





The symbol in the label field is defined as the value of the first expression in the operand field. If the value of the 
first expression in the operand field is not between O and 65,535, the statement is flagged with an error indication 
and the symbol remains undefined. 


The symbol is defined to have a length attribute equal to the value of the second expression in the operand. The 
second expression in the operand may be omitted, in which case, the symbol is defined to have the length attribute 
of the first expression. 


If the value of the location counter is 2000 when the following lines are detected, ‘. 


OPERAND 











TAG has an absolute value of 2000 and a length attribute of 10. HIDE has an absolute value of 2100 and a length 
attribute of 150. SEEK has an absolute value of 20 and a length attribute of 10. 
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4.3. ASSEMBLY CONTROL 

Assembler directives are available to control the program name and initial location, to alter the location counter in a 
specified manner, to indicate the end of the program and the instruction with which execution of the object 
program is to begin, and to contro! the placement of pooled literals. 


4.3.1. Program Start Directive (START) 


The START directive defines the program name and tentative starting location. It must precede all other program 
statements except comments and macro definitions. The format of the START directive is: 





A OPERATION A OPERAND 






symbol decimal or hexadecimal representation 


The expression in the operand field is evaluated and, if necessary, incremented to make it a multiple of two. The 
result becomes the initial setting of the location counter and is the value of the symbol in the label field. This 
symbol becomes the name of the first contro! section and the program name and is available as an entry point 
without being separately defined as such. Although the operand of the START directive is an absolute value, it is 
treated as if it were relocatable. 


Both the value of the location counter and the coding that follows a START directive are relocatable. Any one of 
the following statements will cause the program to be assigned to locations starting at 1068, and to have the symbol 
SORT defined with the relocatable value 1068. 





LABEL A OPERATIONA OPERAND A 
1 1 


1 0 6 
S,O)RiT | |sirjasr tl {1,0,6,7 


sont, 1s) | [siraetl [1,068 


S087, 1.1 | [staRith [X°,4,2,¢1" Seth Echt Miia flea A (en 


A START directive preceded by one or more statements, other than comments or macro definitions, is ignored and 
flagged as an error. A START directive whose operand field does not have a value from 0 to 65,532 is ignored and 
flagged as an error. If there is no valid START directive, the location counter is set to 0. 

















The value stated on the START directive is affected by the e, specification of the ORG directive; see 4.3.3. 


4.3.2. Program End Directive (END) 


The END directive indicates to the assembler the end of the program being assembled. The format of the END 
directive is: 











A OPERATIONA OPERAND 









LABEL 


[symbol] [expression] 
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When the assembler detects an END directive during its last pass, it writes any remaining text data which it has 
accumulated, then writes a transfer record. If the operand field of the END directive contains an expression, its value 
is entered in the transfer record to signify the address at which the program execution may begin. If the END 
directive does not contain an expression in the operand field, the corresponding field of the transfer record is blank. 


lf a symbol appears in the label field of the END directive, it is assigned the current value of the location counter. 
This is normally one greater than the highest address assigned to the program being assembled. 
4.3.3. Assign Location Counter Origin Directive (ORG) 


The ORG directive is used to set the location counter to a specified value. The format of the ORG directive is: 






A OPERATIONA OPERAND 


[symbol] eq[,e9] 


The value to which the location counter is set is determined by the values of the expressions in the operand field. If 
e, is not expressed, then the location counter is set to the value of e,- if e, is expressed, the location counter is set 
to the next value greater than or equal to the value of e, which is a multiple of e,- Some exampies follow. 





Resulting Location Counter Value 


The value of e, must be a number that is the result of 2 raised to a power. 


If e, is used, the value stated on the START directive must be a multiple of the highest e, value expressed in the 
assembly. The assembler assumes a start value of zero until the final pass, when base adjustments are computed. The 
ORG value of e, will be lost if the adjustment factor is not a proper multiple. 





Because the beginning address of each CSECT is based on the ending address of the previous CSECT, and ORG" ,e, 
statement must precede each CSECT directive when such ORG statements are used in the following section, as 
follows: 






A OPERATION A OPERAND 
10 


where: 


e, is the highest e, value used. 
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If a symbol appears in the label field, its value also is the value to which the location counter is set and the symbol is 
ad assigned a length attribute of one. The value to which the location counter is to be set must be either an absolute 
value between 0 and 65,535 or a relocatable value between the initial location counter setting and 65,535. If the 
value is not within this range, the ORG directive is ignored and the line is flagged with an error indication. With the 
ORG directive, it is possible to set the location counter to a value that is not a half-word boundary. 


The ORG directive to set the location counter to a value 603 less than its current setting would be: 


LABEL A OPERATIONA OPERAND A 
1 10 16 
Pe ee 8 ee oe: 


The ORG directive may be used to reserve a number of locations that are not expressed as a single decimal integer. 
For example, to reserve A minus B bytes of storage, where A and B are previously defined symbols, the statement is 
written as: 


O/R,G * +,A,-,B 


Bytes of storage reserved with a DS or ORG directive are not set to zero when the program is loaded. 


If e, isa relocatable expression, the value to which the location counter is set and the coding that follows the ORG 
directive are relocatable. If absolute, the value to which the location counter is set and the coding that follows the 
ORG directive are absolute. 


4.3.4. Assign Literal Pool Origin Directive (LTORG) 


Literals are gathered into one or more pools with elimination of duplicates within one pool at the end of the first 
control section (4.5.4). An LTORG statement directs the assembler to create a pool from all literals detected since 
the last LTORG directive or beginning of the program. It also assigns to the pool the present value of the location 
counter, after adjusting the location counter to a half-word boundary. 





The form of the LTORG statement is: 








A OPERATION A OPERAND 





[symbol] unused 





The label, if present, is assigned the value of the address of the first byte of the literal pool and a length ‘attribute of 
one. 


Because literals are gathered into pools before they are generated and the pools are processed as standard 
specifications, errors are not flagged when the literal is written. Invalid specifications are not discovered until the 
literal pool is dumped. 
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4.4. BASE REGISTER ASSIGNMENT 
The assembler assumes the responsibility for converting storage addresses to base register and displacement values for 
insertion in instructions being assembled. To do this the assembler must be informed of the available registers and 
the values assumed to be in those registers. The assembly directives USING and DROP are available for this purpose. 


4.4.1, Assign Base Register Directive (USING) 


The USING directive informs the assembler that a specified register is available for base register assignment and that 
it contains a specified value. The format of the USING directive is: 

















A OPERATIONA OPERAND 








[symbol] 


Is a relocatable or absolute expression and a, res, are register numbers. 


The second and succeeding expressions in the operand field must be numbers from 8 through 15, denoting general 
registers. The first expression represents the value that the assembler assumes is in the first register at object time. 
That number, plus 4096, will be assumed in the second register, and so on. Thus, if the label ‘ABC’ has a value of 
400, the statement 


OPERAND 








informs the assembler that, at object time, general register 12 contains the value 400, general register 9 contains the 
value 4496, and general register 13 contains the value 8592. 


The registers must be loaded with the correct values by the user program. For instance, the instructions for the 
situation described previously would be: 
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4.4.2. Unassign Base Register Directive (DROP) 


The format of the DROP directive is: 






A OPERATION A OPERAND 


[symbol] 


where: 





pene, 


Are absolute expressions, each with a value from 8 through 15. 


Each expression denotes a general register that no longer contains a value available to the assembler for computing 
base register and displacement values. 


4.4.3. Function of USING and DROP Directives 


The assembler maintains a table of the available registers and the values they contain at object time, the USING 
table. A USING directive adds a register and value to the USING table, or revises the value for a register already in 
the table. A DROP directive removes a register and its associated value from the table. If the operands of a USING or 
DROP directive are not valid, the directive is ignored and the line is flagged with an error indication. 


If an operand address is given as a relative address instead of a base register and displacement specification, the 
assembler searches the USING table for a value yielding a valid displacement; that is, a displacement of 4095 or less. 
If it finds more than one such value, that value yielding the smallest displacement is chosen. If no value yields a valid 
displacement, the operand address is set to zero and the line is flagged with an error indication. If more than one 
register contains the value yielding the smallest displacement, the highest numbered register is selected. 


An absolute address with no indicated base register is treated as an absolute, direct address unless an appropriate 
value is found in the USING table. 


The placement of a USING directive determines the generation of operand addresses within instructions, based on 
that USING statement. The first operand of the USING statement determines the portion of the program that may 
be addressed using the specified register. Thus, if a program contains the coding 
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the B2 and D2 fields of the instruction labeled A contain 10 and 0, respectively. Moreover, if the program contains 
no USING directives for register 10, other than those shown, the second line, labeled A, is the only tine in the 
program for which the assembler would consider 10 as a register available for addressing the line labeled B. 


The SPERRY UNIVAC 9200/9300 Series operating system locator/loader routine places the transfer address of a 
main program in processor register 15 prior to transferring control to it. All other registers must be loaded by the 
program itself in a manner consistent with the information given to the assembler in the USING directives. The 
following example shows how this is done. 


LABEL OPERAND A 
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Lines 2 and 3 of the example exemplify the following general rule: 


An LH instruction to load a value into a general register must precede the USING directive, which informs the 
assembler that the value is available. 


Also, it is possible to specify an absolute value for the first expression in the operand of a USING directive. The 
entry in the USING table made in response to such a USING directive is not used to break down relative addresses. 
It is used, instead, to break down absolute addresses. For example, given the following coding, . 





the B2 and D2 fields of the instruction labeled A will contain 15 and 96, respectively. 
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4.4.4. Direct Addressing 


The machine instruction format provides base register and displacement addressing (indexed addressing) or direct 
addressing. Instructions using direct addressing have a faster execution time. To facilitate error checking by the 
assembler, direct addressing is described to the assembler in terms of the pseudo base registers 0, 1, 2, 3, 4, 5, 6, and 
7, which contain the values 0, 4096, 8192, 12,288, 16,384, 20,480, 24,576, and 28,672, respectively. Thus, the 
direct address 512 would be treated, by the assembler, as an address consisting of a reference to the pseudo base 
register O and a displacement of 512. The address 4098 would yield a base of 1 and a displacement of 512. The 
address 4098 would yield a base of 1 and a displacement of 2. The additional forms of the USING directive available 
for direct addressing are, specifically: 





A OPERATIONA OPERAND 





The first line makes direct addressing available for addresses in the range 0 to 4095. The second makes direct 
addressing available for addresses in the range 4096 to 8191, and so on. The DROP directive also may refer to the 
pseudo registers 0 through 7 to terminate direct addressing. 


A program involving direct addressing still may be relocatable. 


When used in the operand of the USING directive the asterisk (*),.does not indicate the current value of the location 
counter. 





Both general registers and pseudo registers may not be specified in one USING directive. 


4.5. PROGRAM LINKING AND SECTIONING 


The assembler provides, as part of its output, information that allows the results of separate assemblies to be linked, 
loaded, and executed as a single program. Proper partitioning reduces the machine time required to make changes to 
an existing program. !f a change is required, only that part which is changed need be reassembled. The output is then 
linked with the remaining parts to produce the altered program. Proper partitioning of a program also reduces the 
number of symbols required in each of the separate assemblies. 





A symbol defined in the label field of module A and addressed in module B is said to be defined in module A and “| 
referenced in module B. Thus, by using the ENTRY and EXTRN directives, proper linkage is supplied when the 
separate modules are assembled. This information is given to the linker program by the external definition records 
and the external reference records which are outputs of the assembler and inputs to the linker. 
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4.5.1. Identify Entry-Point Directive (ENTRY) 


That portion of a program submitted as input to a single assembly is called a module. Each module must declare the 
symbols defined within that module to which reference is made by other modules. These symbols are declared by 
the ENTRY directive. The directive format is: 





A OPERATION A OPE RAND 






unused symbol,symbol,...,symbol 


Each symbol in the operand field is defined by its use as a label in a line of code within the module and referenced 
by one or more separately assembled modules. 
4.5.2. Identify Externally Defined Symbols Directive (EXTRN) 


The assembler must be informed of all symbols defined in other modules and referred to in the module being 
assembled. These symbols are declared by the EXTRN directive. The directive is: 





OPERAND 






A OPERATION A 


unused symbol,symbol,...,symbol 


Each symbol in the operand field is defined in some other module. 


4.5.3. Sectioning 


The assembler also permits sectioning of input to one assembly. Dividing a program into sections is optional; 
therefore, when writing unsectioned programs, the programmer does not need to know the points stressed in the 
following discussion and the discussion of CSECT, DSECT, and COM. 


in a program without CSECT or DSECT sectioning directives, the entire program is one section that begins with the 
START directive and ends with the END directive. If, however, sectioning directives are used, the first section of the 
program begins with START and ends with a CSECT or DSECT sectioning directive, which also indicates the 
beginning of the next section. Each subsequent sectioning directive informs the assembler of the end of one section 

: and the beginning of the next. The last section of the program ends with the END directive. The sectioning directive 
of each section is named by a label. 


LABEL CFERATION A. OPERAND A 
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(cont.) 


LABEL OPERATION A OPERAND A 


10 16 
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ABLE is within a section named PROG; BAKE is within FROG; and so forth. The last section, a dummy control 
section, ends with the END directive. 


A control section is a group of instructions, constants, and storage areas where positions relative to each other are 
fixed, and must be preserved for proper coding performance. An instruction in one section must not depend on its 
positional relation to instructions or data in another section for its proper execution. Sections appear in the input to 
the assembler in any order along with statements belonging to one or more other sections. The first control section 
begins with the first source statement. If the first statement is a START directive, its label becomes the name of the 
first control section. 


4.5.4. Control Section Identification (CSECT) 


The CSECT directive indicates to the assembler that the source statements that follow belong to a control section 
different from other preceding source statements. Use of the CSECT directive allows the programmer to code parts 
of the logical sections of a program in the order in which he determines the need for them. The format of the 
CSECT directive is: 





OPERAND 






AOPERATIONA 





LABEL 


[symbol] unused 


The label field of the CSECT statement contains the name of the control section. This symbol must not appear in 
the labe! field of any other source statement except another CSECT statement. It is the name of the control section 
and is defined as an entry point of the program being assembled. The value of the symbol is the address of the first 
byte of the control section. {f the label of the CSECT statement has appeared as a label of previous CSECT 
statement, the succeeding statements are a continuation of the control section of that name. ‘ 

A programmer may find the use of CSECT convenient if, in the past, it was necessary to discontinue coding a section 
of a program to code another section upon which the original section is dependent. Shuffling of coding sheets is 
eliminated by setting up the new section with a CSECT directive and continuing. After the second logical section is 
coded or even partly coded, the programmer can revert to the original section by writing a CSECT directive with the 
same label given to the original section. The assembler reorganizes parts of each section and assembles it as one 
continuous control section. It is important to note, however, that neither the listing nor the sequence of object 
coding is reorganized. The reorganization that takes place is with respect to the final structure of the coding within 
main storage after loading; the addresses of the coding within main storage are indicated on the listing. 
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LABEL OPERAND A 
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Assembled output: 


First section labeled BILL — all of coding 1A, 1B, and 1C; 
Second section labeled MIKI — all of coding 2A and 2B. 


Operational conditions: 


a Direct addressing between control sections must not be attempted. 

a The first CSECT with a unique label also sets up an automatic entry point. 

a An ORG directive with "eo in the operand must be placed at the end of any CSECT when such ORG 
directives appear in succeeding sections; the ey specification must be the highest e, specification used 
(4.3.3). 

NOTE: 


Modules which contain sections defined by CSECT and COM directives with duplicate names must not be 
linked to one another, A blank label field is permitted as a legitimate label of spaces only once. When both 
CSECT and COM directives have no labels, the label used for both is spaces; however, only one label of spaces 
is permitted, 


USING directives in different sections that define the same register must be redefined when each section 
is reentered. 





he ht See 
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4.5.5. Dummy Control Section Identification (DSECT) 


The DSECT directive indicates to the assembler that the statements which follow are used to redefine a data storage 
area reserved either in the module being programmed or on another separately assembled module. If the data storage 
area is reserved in a separately assembled module, that module is later linked to the module containing the dummy 
control section. No storage is reserved for a dummy control section. Data and instructions appearing in a dummy 
control section do not become part of the assembled program. The format of the DSECT statement is: 






AOPERATION A OPERAND 


[symbol] unused 


A DSECT statement may not contain a blank label field in a program that either contains no START statement or 
contains a START or CSECT statement with a blank label field. 


An LTORG directive may not appear in a dummy section. Labels of statements in a dummy section are called 
dummy labels. 


The following rules must be observed in the use of dummy labels: 


a An unpaired dummy label may appear only in an expression defining a storage address for a machine 
instruction or a constant of type S. 


a A base register may not be designated for this address field, but the resulting value must be covered by a 
USING statement. 


a The programmer must ensure that the appropriate value is loaded into the register specified in the USING 
statement. 


The fast source code input to an assembly must not be part of a dummy control section. 


"More than one dummy control section can be used within a module. 
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Example: 


PROGRAM___ MODULE A PROGRAM MODULE B 





LABEL A OPERATION A 
} 10 16 
EASE 1, , | las.ect! |2,0,9,5 
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In module A, the symbol AREA, defined as an ENTRY point, is specified as 260 bytes. 


In module B, the base address of AREA is externally defined. Portions of AREA are redefined by DSECT as FLDA, 
containing 2 bytes, and FLDB, containing 4 bytes. FLDA and FLDB are relatively addressed as location 0 and 
location 2, respectively. Before FLDA and FLDB are addressed, register 9 must contain the base address of LAKE, 
which receives its true value at linker time. 


4.5.6. Common Storage Definition (COM) 


The ENTRY and EXTRN directives provide one mechanism for communication between separately assembled 
routines. The COM directive allows the programmer to define a control section that is a storage area common to two 
or more separately assembled routines. One assembly can define only one common section. Each COM statement, 
after the first, defines a continuation of the common section previously defined. The assembler reorganizes all 
common sections in a given assembly into one common section. Like the CSECT directive (4.5.4), neither the listing 
nor the sequence of object coding is reorganized. The last source code input to an assembly must not be a part of the 
common section. The format of the COM statement is: 





A OPERATION A OPERAND 






unused unused 


Statements following the COM directive may be DS and DC directives used to define labels appearing within the 
section. Like the dummy control section (4.5.5), no data or instructions are assembled into a common section, nor 
may an LTORG directive appear in a common section. Data is entered into a common section only by execution of 
a program that refers to it. Unlike a dummy control section, a common storage is directly addressed by a program 
that defines it. 
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When several routines defining common storage are linked, the resulting module contains only one common section, 
corresponding to the longest common section in any of the input modules. The linker places the one common 
section above the highest address of any module or above job control’s highest address, whichever is larger (Figure 
4—1). In addition to being common to more than one module making up a loadable program, the common section 
can be made common to more than one link in a chain of programs by use of the CHAIN command card (Section 8). 
When programs are chained, the linker relocates the common section above the highest location in any chained 













program. 
NOTE: 
The linker always relocates the common section to an address higher than the highest located phase and higher than 
job control. 
‘PROBLEM PROGRAM 
ee 
LOCATION 
PHASE 1 PHASE n 
1000 1000 1000 
MODULE A MODULE X 
4999 
JOB CONTROL 5800 
MODULE B MODULE Y 
5999 
6999 
7000 
7999 (UNUSED) 
8000 





COMMON SECTION 


Figure 4—1, Relocation of the Common Section 
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In module A, two common storage areas are defined by lines 1 and 2. The COM specified by line 2 is a continuation 
Ae of the COM specified by line 1. 





In module B, the COM specified by line 3 uses the common storage area initially defined by line 2. 


NOTE: 





Modules which contain sections defined by CSECT and COM directives with duplicate names must not be linked to 
one another. A blank label field is permitted as a legitimate label of spaces only once. When both CSECT and COM 
directives contain no labels, the label used for both is spaces; however, only one label of spaces is permitted. 





4.6. LISTING CONTROL 


One output of the assembler is a source and object code listing. An assembler directive is available to control the 4 
listing content. 4 





4.6.1. Listing Content Control (PRINT) 
The PRINT directive provides control over the listing content. 


The following are available options: 





a No listing 


a Listing not including lines generated by macro instruction calls 


C ) 


. Listing including all lines = 


The format of the PRINT statement is: 












A OPERATIONA OPERAND 


unused 
where: 
ls ON,GEN to print the lines generated by a macro instruction. 


ON, NOGEN to print the macro call, but not to print the lines generated by a macro instruction. 


OFF to produce no listing, except for lines on which errors were detected. 





One PRINT statement controls the listing of source and object statements until the next PRINT statement is 
detected among the source statements. The settings before the first PRINT statement are ON and GEN. The settings 
for operands omitted in a PRINT statement are not altered by the PRINT statement. 
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4.6.2. Listing Format Control (SPACE) 


The SPACE directive provides control over the format of the listing. 





The format of the SPACE statement is: 

















A OPERATION A OPERAND 


unused 


Is 0 or blank, which is equivalent to 1 line space. 
1—999, the number of lines to be spaced over; form overflow terminates spacing. 
Spacing continues until a form overflow condition occurs, at which point a home-paper command is issued and 
spacing is discontinued. 
4.6.3. Listing Format Control (EJECT) 
The EJECT directive provides control over the format of the listing. 


The format of the EJECT statement is: 
















OPERAND 





A OPERATION A 





unused 


The EJECT statement causes a home-paper command to be issued, which results in the next line being a title line on 
a new page. 


4.6.4. Listing Format Control (TITLE) 


The TITLE directive provides control over the format of the listing. 





The format of the TITLE statement is: 










A OPERATIONA OPERAND 


unused 








4-19 
PAGE 





7508 Rev. 3 
UP-NUMBER 


UNIVAC 9200/9200 11/9300/9300 Il SYSTEMS 






PAGE REVISION 


Is a string of up to 54 characters. 


The title line is contained within apostrophes to permit centering of the title in the case of leading 
blanks. Two consecutive apostrophes are necessary to express an apostrophe within the body of the title. 
If the apostrophes are omitted, the operand field is still used as a title; however, the data is left-justified. 


The TITLE statement permits identification of many pages of listing under a common title that appears 
at the top of each page. The operand of the TITLE statement is printed on all succeeding pages until a 
new TITLE statement is detected. When a TITLE statement is read, the assembler advances the printer 
form to the top of the next page. 





4.7. INPUT CONTROL 


The assembler provides optional sequence checking of source statements. 


. 4.7.1, Input Sequence Control (ISEQ) 


The ISEQO statement directs the assembler to perform a sequence check of the source statements on columns 76—80. 
The format of the ISEQ statement is: 





A OPERATIONA OPERAND 


unused 





Sequence checking begins with the source statements following the ISEQ statement. It is terminated by an END 
statement. 


Only one ISEQ directive can be in a source code module, and it must be the first statement in the source code 
following any macro definitions. The 1SEQ directive has effect for source code only. In the absence of an ISEQ 
directive no sequence check is performed. 


4.8. ERROR CONTROL 


The assembler provides two indications of errors during an assembly. 


4.8.1. User Program Sense Indicator (UPS!) Byte Setting 





If an error is detected during assembly, the single bit of the UPSI byte (location X‘'117’), shown as 1 (00000100), is 
set to 1. This permits detection of errors by a subsequent program in the job stream or by a / SKIP job control card, 
providing a / JOB card does not intervene. The assembler never resets this bit to zero; therefore, any error in a series 
of assemblies may be tested for after the last assembly. 


4.8.2. Total Error Count 


A total error count is available on the last line of the assembly tisting. This line always prints no matter which print 
options have been chosen. (See 7.4.1 for the format of this final line.) 
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5. Macro Instructions 





5.1. MACRO INSTRUCTION FORMAT 


Each source statement causes the SPERRY UNIVAC 9200/9300 Series Tape/Disc Assembler to take one specific 
action or represents a single constant or machine instruction. The assembler contains a library facility, where one 
source statement may result in the inclusion of many lines of code determined by a predefined pattern of code 
called a macro definition. The macro definition may be contained either in a library of definitions or included with 
the source statements of the program being assembled. The statement requesting the inclusion of the code is called 
a macro instruction. If a macro definition is included with the source statements, it must precede any macro 
instructions referring to it, precede the START card, and may not appear within the source code proper. 





A macro instruction is similar in form to a source code instruction. It contains a label (optional), an operation code, 
and an operand consisting of none or one or more expressions separated by commas. The prime difference is that the 
macro instruction causes the generation of a series of source code instructions representing a number of assembler 
operations; whereas a source code instruction causes the assembler to do one specific operation. 








The format for a macro instruction is: 





OPERAND 






A OPERATIONA 






[symbol] P1,P5,P3,... »PayNy=Pai 1 No=Pny2N3=Pp3)- oN n= 


Poim 





The label may be any symbol, but is not necessarily assigned the current value of the location counter. The 
operation is the name of the macro definition describing the pattern of code to be included. The operand, P, 
through Pe Sec? is a sequence of expressions specifying parameters. 


P, through Ps are positional parameters. Ps is through Pe +m are keyword parameters. A macro instruction may 
have parameters of either or both types, or none at all. . 


5.1.1. Parameters 


Alt positional parameters must be specified before any keyword parameters are specified. The order of the 
expressions in the operand determines the order of the parameters specified. Parameter specifications are separated 
by commas. When a positional parameter specification is omitted, the comma must be retained to indicate the 
omission. Thus, if a macro instruction contains positional parameters and the second is not specified, the operand 
appears as: 





P,P. 


i" 3 
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If the third parameter is not specified, instead of the second, the operand is written 


P,P, 


No trailing commas need be included. 
The specification of a keyword parameter is: 
N=P 


where N is the name of the parameter (any symbol of seven or fewer characters is a legitimate keyword name) and P 
is the parameter specification (a value or a character string). Keyword parameter specifications are separated by 
commas; however, the comma need not be retained if the specification is omitted. A comma must be between the 
last positional parameter and the first keyword parameter. The order of the keyword parameter specifications is not 
significant. For example, if a macro definition contains three keyword parameters, the operand of the macro 
instruction might be: 


N, =P, ND =PoiN3=P 
or 

No =PL oN, =P, N3=P, 
and so on. 


A macro instruction may contain positional and keyword parameters with commas separating the specifications. For 
example, the operand of a macro instruction with three positional and two keyword parameters might be: 

PPP aN, PA N,=P5 
The number of parameters that may be specified with one macro instruction depends on how much space is required 
to store the specifications. One macro instruction may ordinarily specify as many as 50 parameters in its operand. 
When the operand overflows the space provided in one record, provision is made to continue the operand in the 


following record by putting a nonblank in column 72. The continuation of the operand begins with column 16. The 
macro pass of the assembler searches for a continuation record as soon as one of the two following events occurs: 


] Information is taken from column 71 of the current record. 
= A comma, followed by a space, is detected in the current record. 
Columns 1 through 15 of a continuation record must be blank. If the information in a record is terminated prior to 


column 71 by a comma followed by a space, comments may be written after the space. For example, a macro 
instruction with three keyword parameters might be written as: r 


OPERAND 

















The specification of a parameter may not contain an equal sign or a comma, and may have a maximum of 127 acs 
characters. 
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5.2. WRITING MACRO DEFINITIONS 





The routines for the macro library are written in standard assembler source code and entered in the library by the 
librarian. To distinguish one macro from another in the library, three directives are used: PROC, NAME, END. 


a PROC directive 





The first source code statement of a macro definition is a PROC directive in the format: 






A OPERATION A OPERAND 


{symbol] [operands] 





The label may be any symbol, but is optional and, when used, the label in the macro instruction is substituted 
for the PROC label wherever the PROC label appears. For example, if the symbol MOVE were specified for 
the label of a macro instruction; and the label of the PROC directive of the associated macro definition were 
NAME, and an instruction within the macro definition were to contain the following line of source code, 





OPERAND 





then the source code generated by the definition would appear as: 


Vv M|V,C DE iS: Ti, ORIG ie 


!f the PROC directive does not contain a label, but the macro instruction does, that label will remain 
undefined. 


a NAME directive 


The second line of a macro definition must be a NAME directive in the format: 






A OPERATION A OPERAND 





symbol [operand] 


Symbol is the name by which the macro definition may be called, and is the name specified in the operation 
field of the macro instruction calling it. As many as eight characters may be in a label; the first must be 
alphabetic, the others alphanumeric. 
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a END directive 
The end of a macro definition is indicated by an END directive. It has no operand and requires no label. 


If the following macro definition is in the library, 


LABEL Hes OPERAND A 


16 


D,ES,T, |0,R,1,G6 boa 
por tis ip bani t 


A 
EI 
E AME 
| fav 
ff 


= | — 

oO | 

< 

m 
a 





the macro instruction 


MjO,.V,E 


is equivalent to the source code instruction: 


MVC D,E,S,7T,,JO,;R:1,6 





Note that none of the directives (PROC, NAME, END) is output of the macro pass. 


5.3. INCORPORATING PARAMETERS INTO MACRO DEFINITION CODING 
The operand of a PROC directive, when used, is: 


p.nN, NG Ngee, 
The first expression, p, in the operand is a symbol used to address the parameters within the macro definition. This 
expression and its use are explained in this section. The second expression, n, is the number of associated positional 
parameters. N gee are the names of the keyword parameters. Any symbol of seven or fewer characters is a 
legitimate keyword name. Listing the keyword parameters in this way makes them positional parameters to the 
macro definition. 


For example, if the PROC directive is the following format: . 






A OPERATION A OPERAND 


unused P,3,N1,N9,N3 


The macro definition contains three positional parameters, Py. Po. and Pe and three keyword parameters, N, N 
and N,- Thus, the keyword parameters become, in effect, positional parameters P a Poe and Po: 
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The value specified for a parameter is substituted in the coding for the expression: 


i 
Pon) 





where p is the first expression in the PROC directive operand and n is the number of the positional parameter. The 
first is numbered 1, the second, 2, and so forth. As an example, if the following macro definition is in the library, 








LABEL OPERATION A OPERAND A 
1 10 16 — 
PiR,0,c, | Py, 10,, DES: Ty LG, TiHy, OF Ril 1G a 





prove tore Peg pte tie ta 





Zl 

mame: | | 

M}V,C det) CPC ,2) 0 Pl 3) 
eS 











is equivalent to the source code instruction. 


forse tis | wiv s | lowrete t 


A keyword parameter also is addressed by preceding its name with an ampersand. Thus, the MVC instruction within 
the macro definition of the previous example could have been written: 


MIViC & DIEWS Ti LiGiTIH &,OIRIIIG 


lf a parameter whose value is not specified in the macro instruction is a complete term in an expression containing 
more than one term, it is replaced by the value zero; otherwise, it is replaced by the null character string (the 
character string that contains no characters). 


5.4. NAME DIRECTIVE 





More than one NAME statement may follow the PROC statement of a macro definition. (All the NAME statements 
must immediately follow the PROC statement.) Each such NAME statement specifies a different name by which the 
same macro may be catled. 
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The object of giving more than one name is to permit reference to different versions of the procedure embodied in 
the macro definition. The versions are distinguished by the operands of the NAME statements. 


Only one expression may appear in the operand of a NAME statement and may be assigned a value ranging from 
zero through 65,535. This expression is essentially a parameter of the macro and may be addressed within the macro 
definition as: 


p(0) 


where p is the first expression in the PROC statement operand; consequently, it may be used to distinguish between 
versions of a macro definition. 





For example, if the following macro definition is in the library, 











LABEL A OPERATION A OPERAND A 
UZ 10 16 
Pei ty | lpino.c, | Ie 
mv. ts | AME, | [4 
mvs ty 1 | NAME, | |p 
pyr YY : 0 ORG) pri itiiiitiiiit 
the macro instruction 
M|V,.4 
would produce the source code 
MIV,C DEST .( 14.) ,,,0,RI1,G Ss Ce EN aes Cn WE ORY Vl aed CoV | 
and the macro instruction 3 
MV 8 poirutirirt t 


would produce: 





M|ViC T RiliG 
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\f a NAME statement contains no operand, the parameter p(0) is assigned a value of zero. 


If a macro definition contains no parameters and it makes no reference to the operand of any of its NAME 
statements, its PROC statement has no operand. 


If a macro instruction requests the inclusion of a macro definition of a given name, and, if one with such a name is 


included in the source statements of the program being assembled, it is included, even if one of the same name is in 
the macro definition library. The user may override a library macro definition with a macro definition of his own. 


5.5. BUILT-IN MACRO DEFINITIONS 





The following names must not be assigned to macro definitions because they are already assigned to macro 
definitions permanently built into the assembly structure: 


CLOSE READ LBRET 
CNTRL SETL ESETL 
GET TRUNC EOJ 
OPEN WRITE MSG 
PUT WAITF CANCL 


FETCH 
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6. Conditional Assembly Instructions 











6.1. GENERAL 





The SPERRY UNIVAC 9200/9300 Series Tape/Disc Assembler recognizes certain directives that can exclude lines of 
coding from the output of the assembly, include a set of lines in the output of the assembly more than once, and can 
establish and alter values that may be used to determine whether a set of lines shall be included or excluded. 


These directives are for use within a macro definition to control the pattern of generated coding, based on the 
parameters supplied by the macro instruction. 


6.2. DO AND ENDO DIRECTIVES 


A DO directive controls the inclusion or exclusion of the lines following it up to its associated ENDO directive. For 
example, in the following sequence of coding, 





DO 1 


2 


DO 3 


ENDO 6 


8 





ENDO 9 


the first ENDO directive is associated with the second DO directive and the second ENDO directive with the first DO 
directive. In other words, DO and ENDO directives are paired to produce nests. Thus, the first DO directive controls 
lines 2 through 8 and the second DO directive controls lines 4 and 5. DOs may be nested to a depth of 10. 


The operand field of a DO statement contains a single expression. If the value of this expression is greater than zero, 
it represents the number of times the lines controlled by the DO statement are included in the output; otherwise 
these lines do not appear. For example, if the following macro definition is in the library, 
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OPERAND A 
DES T.,jOR.1.G 


A 
Fi 
i 
| lewd) 
a 
| 
ai 


the macro instruction 


[Lu rita | wove | CRen fiat i ee Lt L 4 = i | 


would produce the instruction 


= 


v,c D.E.S,T,,j{9,R,! G 


in the output of the macro pass; whereas, the macro instruction 


would not produce the instruction. 


Note that the macro instruction shown below also would suppress the instruction. 


arereres eres C7 vette Ry pe ep 


A DO statement may contain a symbol in the label field, which may be used only in the statements controlled by 
the DO. Its value is 1 the first time these statements are generated, 2 the second time they are generated, and so on. 
If the DO is under the control of another DO and is reactivated, the count begins at 1 again. 





6.3. GOTO AND LABEL DIRECTIVES 


The format of the LABEL statement is: 





A OPERATION A 






OPERAND 






symbol unused 
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The symbol in the label field of the LABEL statement is not defined in the usual sense. It may be used only in the 


operand field of a GOTO statement. 


The GOTO directive directs the assembler to another point in the macro definition in its production of source code. 


The format of the GOTO statement is: 









A OPERATION A 


unused 
The symbol in the operand field must be the label of a LABEL statement. 


If the following macro definition is available, 


LABEL OPERAND 


P,, ,0O,, ,FJO,U,R 


DES ,T (| 8)) ORI 1, G 


= — 
y oO 
o < 
m 
ae ee es ee a 
oO 
°o 
4 
oO 
[ae eh a ee 
m 
Zz 
i=) 


OPERAND 





Pepa te rey ba yp be 





! 


| ! | 
eiabe te Os Pee ES wT VEY Ce 


the macro instruction 


L. i | | fwo.we | feoww.Rictts a Ly i 


would produce the instruction 


MV,C D,E.S,7,(14,) ,., 0, RIt,G 


and the macro instruction 


MO. VIE 


would produce the instruction. 


MLV,C DEST, ((8,),, ,O,R11,6 
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snes 


If the GOTO statement is in a macro definition, the corresponding LABEL statement must appear in the same macro 
definition. 


tf a GOTO is within the range of statements controlled by a DO statement, but the addressed label is not, execution 
of the GOTO terminates the DO. Termination takes place whether the count, as expressed in the operand field of 
the DO statement, is exhausted or not. ; 


NOTES: 


7. If a backward GOTO is itself within the range of a DO statement, the GOTO may not pass control to a LABEL 
that is outside the range of that same DO statement. 


2 ALABEL that is the object of a backward GOTO may not reside within the range of a DO statement, unless 
the respective GOTO also resides in that same range. 


Both rules must be strictly observed to avoid unpredictable results. 


ALLOWED: NOT ALLOWED 


6.4. CHARACTER EXPRESSIONS 
A character expression is either a character value or a concatenation of character values. 


A character value is a string of up to 127 characters enclosed in single apostrophes. Apostrophes within the character 
string must appear as two successive apostrophes. Ampersands within the character string must appear as two 
successive ampersands except for an ampersand that is the first character of a parameter or set variable reference. 


6.5. SET VARIABLES 


A set variable is a symbol to which a value is assigned during the generation of the code of a macro definition. Unlike 
an ordinary symbol, the value assigned to a set variable may be altered during the course of an assembly. A set 
variable may be either a local or a global variable. A global variable, once declared and given a value by a SET 
statement, remains defined throughout the assembly and retains the same value until that value is changed by 
another SET statement. A local variable is defined only within the macro definition in which it is declared. The value 
of a local variable within one macro definition is not affected by the declaration of a local variable with the same 
name in another macro definition. 


Before a set variable can be set, it must first be declared by a GBL or an LCL directive. The symbol naming a set 
variable must consist of seven or fewer characters. 
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6.5.1. GBL Directive 


The GBL statement format is: 





A OPERATION A OPERAND 






unused 





symbol,...,symbol 


Each symbol in the operand field of the GBL statement is declared to be the name of a global set variable. Each 
symbol must consist of seven or fewer characters. 


6.5.2. LCL Directive 


The LCL statement format is: 





A OPERATIONA OPERAND 






unused symbol,...,symbol 


Each symbol in the operand field of the LCL statement is declared to be the name of a local set variable. Each 
symbol must consist of seven or fewer characters. 


6.5.3. SET Directive 


The SET directive assigns a value to a set variable. The format of the SET statement is: 





A OPERATION A OPE RAND 






symbol expression 


The symbol in the label field is the name of the global or local set variable to which a value is being assigned; the 
expression in the operand is the value to which the set variable is to be set. The value of the expression may range 
from zero through 65,535. Until a GBL or LCL variable is set by a SET directive, it has the following value: 





a If referenced as a complete term in an expression containing more than one term, zero; 


a otherwise, the null character string. 





Once it has been set to a specific value by a SET directive, the set variable retains that value until it loses its 
declaration or is set to another value by another SET directive. 


Declaring a set variable does not affect its value. 
A set variable is addressed by preceding its name with an ampersand, except that if a local set variable has a name in 


the form L%xx, or if a global set variable has a name in the form G%xx, the set variable may be addressed by its 
name alone. 
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6.5.4, Relational and Logical Operators 
Expressions in the operand field of all machine instruction and most assembler directives contain only the arithmetic 
operators add, subtract, multiply, and divide. The expression in the operand field of a SET or DO statement may 
contain the arithmetic operators, but it may, in addition, contain the following: 
Relational Operators 
greater than (>) 
equal (=) 
less than (<) 
Logical Operators 
logical AND (**) 
logical OR (++) 


The relational operators compare two (unsigned) binary numbers. The value of a relational expression is 1 if the 
relation is satisfied; otherwise, it is zero. Thus, if CHANNEL is the name of a keyword parameter, the expression 


&CHANNEL=5 


would have a value of 1 if 5 had been specified as a value of the parameter CHANNEL; if 5 had not been specified, 
&CHANNEL=5 would have a value of zero. 


The logical operators treat a value as a bit string of 16 bits and produce a 16-bit value. The logical AND operator 
corresponds to the NC instruction and the logical OR operator corresponds to the OC instruction. 


The precedence relation of the various operators in decreasing order is: 

se 

2 =«+- 

3. 7° 

4, ++ 

5. >e< : 


Parentheses may be used to override the precedence relation. Parenthetical expressions may be nested to 14 levels. 


6.5.5. Use of Character Expressions 


Although set variables may have 2-byte binary values, they also may have character values of up to eight bytes. A set 
variable must not be assigned both types of values in one assembly. 


A character expression also may appear as an operand of a relational operator. The following rules apply: 


am] A numeric value is greater than a character value. 
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A character value is greater than any shorter character value. 


A series of characters enclosed by separators is considered a character string. The following are separators: 


A character string that matches a positional parameter designation or set variable name of the form L%xx or G%xx 
and is not enclosed in apostrophes will be accepted as the name of that set variable. Such a character string must be 
enclosed in apostrophes to be treated as a character value. If the operand field of a SET or DO statement contains an 
expression that could not otherwise be evaluated, that expression is treated as a character value even though it is not 


&(* >.) /= Att <,- 44+ 


enclosed in apostrophes. 


The following is an example of the use of a local set variable. If the following macro definition is in the library, 




















, LABEL Q OPERATION A OPERAND A 
po PINS 0, .AIG,T arate ceeey beeen 
BONE LL. ALE - pot ee Pa a 
Lic L & L,%,0,0 eet eae 

& ,L,%,0,0 | |sie,t fatiblaci 8 

| lpjo & |L,%,0,0 
Te | |p €,5,7,, (0,R,1,6 

ire Ba es oe eet eae Soe We Soe ey a 

wa | demo, 





the macro instruction 


MOVE A,C,T.=,Y|/E,S 


would produce the source-code instruction. 


= 


V,Cc DE S;,T,,{O,Ri1,G | 


Any other form of the MOVE macro instruction would suppress production of the source-code instruction. 
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The following is an example of the use of a global set variable. Assume the following two macro definitions are in 





the library. 
LABEL OPERATION A OPERAND A 

1 10 16 

P/R OC P,0O, A|CT: ds 
G1VE N/A ME 

GIBLL &G,%,0,0 etl | | l 
& G ,%,0,0 S,E,T P( 1.) =)’ YES,’ 

&, G,%,0,0 


DE. S,T,./0,R, 1,6 


sto ba a 


TAKE 
G,%,0,0 


Oo |& 


R,i,G,, |DES,T 


FR OC PE Se a ee | 
RR RE Fama a a Ge 


= vu = 

ia < a < 

= a °o a 
a 


If the only macro instructions in the source statements for a particular assembly are the following, 








. 


If the only macro instructions in the source statements for a particular assembly are the following, 


GIVE 


puso ee AE 


no source code would be produced. 


\f the only macro instructions in the source statements are the following, 
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the following source code would be produced. 


OPERAND 








Thus, the value of a global set variable is determined by the order of the macro instructions in the source statements. 


6.6. CONCATENATION 


A symbolic parameter or set variable with its leading ampersand may be concatenated with other characters, other 
symbolic parameters, and other set variables. If the name of a parameter or set variable is to be followed by another 
alphanumeric character, a left parenthesis, or a period, then a period must be inserted between the parameter or set 
variable name and the character that is to follow it. The result of this concatenation is the one obtained by replacing 
each parameter or set variable name and the period that follows it, if any, by the characters corresponding to that 
parameter or set variable. The following is an example of the use of concatenation. Assume the following macro 
definition is in the library: 











CRs Wr SaPST HE CE POW NY Ta RS VTE SN Ce De Oe Wc a a 
ZR NIN, 4 2 SMM 











AB Cerise pi) Ae ee a 








Bewore eee 6 Mids Mil yoo el ie ei ee 











aS tat oO OEE Td TT a eS ati 






















1 
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i 
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7. Preparation For Assembly 


7.1. GENERAL 


For an assembly to be performed by the SPERRY UNIVAC 9200/9300 Series Tape/Disc Assembler, certain cards 
are required to appear in the contro! stream. One card that is always required is an EXEC card in one of the 


following formats: 


LABEL A OPERATION A OPERAND A 
10 


1 16 
Ye si ste | lemec, | Jasons 
Perenaes | B 


pty gp a Pt 








. 


for the 8411/8414 disc assembler. 
This may be followed by any of the following PARAM cards in any order: 


a 14,9, .11,0,-,o,4jt Put mame terre tiriria tl 
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where: 


inputid 
Is groupname1/groupname2/ .../modulename if the source program is the module named “module 
name” located within a specific nest of groups on the input file; /modulename if the source program is 
the module named ‘‘module name”’ and selectivity based on the group structure is not required. 


x 
If source input is from tape, this parameter will cause the source input tape to stay open and allow 
stacked assemblies without rewinding the input tape; x is any nonblanks. 

outputname 
Is the name of the output module as it will be entered in the ELT record. 

flags 
{s a string of letters identifying the flags to be associated with the output module in its ELT record. If an 
asterisk (*) is used as the first character in the flags parameter, the option of rewinding logical unit 1 
(rather than backspacing while using it as a scratch tape) is used. Stacked assemblies are still possible 
because the rewind option does not affect assembler use of the flags parameter in any way. 

libeid 


is groupname1/ .../groupnameN identifying the nest of groups in the macro library within which the 
library search is to be performed. The macro library is located on logical unit zero for the tape 
assembler. For the disc assembler, it is assumed to be located in SYSFILE on logical unit zero, unless a 
PARAM 0131 card is used (7.2). 


If the source program is in the control stream, PARAM cards must be followed immediately by a DATA card, which 
precedes the source program. This DATA control card must contain a T in column 16. In this case, the PARAM card 
defining inputid is omitted. If the PARAM card defining the name of the output module is omitted, the label of the 
START directive is taken as the output module name. The PARAM card defining the flags is omitted if no flags are 
to be associated with the output module. The PARAM card defining the limits of the library search is omitted if the 
entire macro library is searched. The name of the entire library is MACROLIB. If libeid is specified as the number 9, 
the assembler assumes that no calls requiring a library search are made in the program to be assembled. 


Macro definitions may be submitted with source code and must precede the source code in the input deck. When the 
assembler detects a macro instruction, it searches the macro definitions submitted with the source code before it 
searches the library. Each macro definition in the library should be preceded immediately by an ELT demarcation 
record. Also, the very first line of each macro definition must be the PROC directive. 


7.2. GENERAL PROCEDURES FOR DISC ASSEMBLERS 


In addition to the preceding PARAM cards, other PARAM cards apply specifically to the disc assembler. General 
notes pertaining to these cards are: 


a Logical unit numbers may be 1- or 2-digit hexadecimal numbers between O and 3F. 
a Filenames must contain a maximum of eight characters. 


a The output file and the scratch file must be unique; that is, neither file may contain the same filename and 
logical unit as any other file. Neither file may be SYSFILE on logical unit zero. 


This PARAM card is optional for 8410 disc units, and it is not used for 8411/8414 disc units. It is used to specify 
that all disc writes are to be verified (check read); if this PARAM card is omitted, no verification is made: 
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LABEL A beled tae OPERAND A 


a eae O(N 
gar te cll AEE S Wear eee wee 





where: 
N = Do not verify all disc writes. 
C= Verify all disc writes. 


This PARAM card is required because it defines the final output file: 





where 

Ww 
Specifies that the file is not to be extended; i.e., the object module is to be written at the beginning of 
the file. 

E 
Specifies that the file contains information to be preserved and extended; i.e., the object module is to be 
written immediately after all other modules contained in this file. 

nn 
Specifies the disc logical unit number in hexadecimal (0 through 3F). 
NOTE: 
Logical unit numbers may be a 1- or a 2-digit number (n or nn). 

filename 


Specifies the name (maximum of eight characters) of this file. 


This PARAM card is required and is used to define a file that is to be used as a scratch file if the source code is on 
cards, or is to be used as the input file if the source code is on disc. If this file is to be used as a scratch file, it may 
not be called SYSFILE if it is mounted on logical unit zero. 
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where: 





nn 
Specifies the disc logical unit number in hexadecimal (0 through 3F). 


NOTE: 
Logical unit numbers may be a 1- or a 2-digit number (n or nn). 


filename 
Specifies the name of this file. 


This PARAM card is required and defines a scratch file: 


LABEL A OPERATION A OPERAND 
10 16 











where 
nn 
Specifies the disc logical unit number in hexadecimal (0 through 3F). 
NOTE: 
Logical unit numbers may be a 1- or a 2-digit number (n or nn). 
filename 


Specifies the name of file. 


This PARAM card is optional and is used to define the file in which the macro instruction library is stored: 














where 
nn ‘ 
Specifies the disc logical unit number in hexadecimal (0 through 3F). 
NOTE: 
Logical unit numbers may be a 1- or a 2-digit number (n or nn). 
filename 


Specifies the name of the file in which the macro library is stored. 


If no PARAM card is specified, there is a default of OO,SYSFILE. 
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7.2.1. Disc File Organization 





The disc assembler works with five files, represented as: 
FILEA — The system file (normally on logical unit 0 and called SYSF1LE) is used for locating 
macro definitions and fetching assembler overlays. 
FILE B — The final output file; also used as an intermediate scratch (PARAM 0101). 
FILE C — ___ This is a scratch file (PARAM 0111). 
FILE D - One file used, either as the input source code file, or, if the input is on cards, as a 
scratch file (PARAM 0121). 
FILE E _ If used, specifies the file in which the macro library resides (PARAM 0131). 
{t is recommended for efficiency of time that the following setup be used: 
a For greatest efficiency, five separate discs can be used for the foregoing files. 
s If less than five discs are used, the files may be set up as follows: 
SYSFILE — FILEA Normally on logical unit 0 
Final output — FILE B Set up on a different LU from file C 
e Scratch — FILE C Set up on a different LU from file B 


Input or scratch — FILE D Set up on a different LU from file C 
and a different LU from the SYSFILE (FILE A) 


MACRO library — FILE E Set up on a different LU from file C 


Some examples of disc drive assignments are shown in Figure 7—1. 






2 drives 





3 drives 






4 drives 


atl Figure 7—1. Disc Drive Assignment Examples 
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7.2.2. Allocation of File Space for Disc 


A disc assembler user allocates space to his assembler files based on his needs and the type of assembly being run at 
any particular time. The sizes vary, depending on: 


® the amount of space a user can afford at assembly time; 
2 the number of disc units available; 

@ ~—_whether the bulk of input is cards or disc; and 

a whether macro are being submitted with source code. 


The following discussion concerns the use of scratch files by the assembler. The available space in the final output 
file also is used as scratch space. 


The assembler generates one internal item, and possibly more, for every source item processed. If the source item is a 
macro instruction, the item generation and required space will be expanded dynamically during generation of the 
instruction. Thus, since each case is different, the user can choose to allocate space based on each assembly or set up 
an all-inclusive allocation procedure to handle the largest assembly that he expects to turn out. In view of these 
possibilities the following guideline is proposed. It is intended as a guideline only and may or may not satisfy the 
requirements of a particular installation. 


It is assumed that the reader has a knowledge of the disc types and is aware of the requirements and procedures 
necessary for the operation of the VTOC for the 8410 disc subsystem (see the 9200/9300 systems 8410 disc 
subsystem utility programs manual, UP-7668) or the DASM for the 8411 or 8414 disc subsystems (see the 
9200/9300 systems 8411/8414 disc subsystems utility programs manual, UP-7835). 
A typical, large single-phase program is the first pass of the assembler. This module comprises approximately 3000 
source items. The disc 1/O handler generates two items per disc record. Inasmuch as each source item causes the 
assembler to turn out an internal item, 6000 items are to be processed for this assembly. In addition to the 
SYSFILE, the assembler requires three work files to be used in the course of the assembly. Each file must contain 
two extents. The first extent consists of the file directory and the second consists of the file itself. Space allocation 
for the directory may be minimal and file allocation space is the most important consideration. The following space 
allocations were assigned in assembling the first pass of the assembler (with 3000 source records and no macro 
instructions) for each of the three files required: 
@ 8410 disc — 2 items per record, 100 sectors per track 

3000 records = 3000 sectors = 30 tracks 

For file directories, one track per file is allocated. Thirty tracks per file are allocated for file contents. 
a 8411 disc — 2 items per record, 16 records per head 

3000 records = 200 heads = 20 cylinders 

One head per file is allocated for file directories, and 20 cylinders per file are allocated for file contents. 
a 8414 disc — 2 items per record, 25 records per head 


3000 records = 120 heads = 12 cylinders 


One head per file is allocated for file directories. Twelve cylinders per file are allocated for file contents. 
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NOTE: 


Although tthe allocation of directory space during the assembly may be minimal, should the same file be used for 
storage of program libraries at other times, the size of the file directory should be adequate for file usage. 


7.3. GENERAL PROCEDURES FOR TAPE ASSEMBLER 


The tape assembler requires that a scratch tape be available on logical unit 3, that its input, if on tape, be on logical 
unit 2, and that a tape be available for writing on logical unit 1. This tape must be either a rewound scratch tape or 
must be in library tape format positioned immediately past the tape mark. This tape is used for scratch as well as to 
receive the final output. If the tape units are not assigned properly, SWAP cards to effect this assignment must 
precede the EXEC card. 


7.3.1. Restart Procedure for Final Phase of Assembly 


After the assembler has begun producing its printed output, two restart options are available: stop printing and 
repeat printing. 


7.3.1.1. Stop Printing Option 


If it is necessary to abort the production of printed output because of forms misalignment, torn ribbon, or other 
printer malfunctions, the stop printing option may be invoked by the operator by setting the DATA ENTRY 
switches to any vaiue from X‘01’ to X’OF’ and pressing the OP REO switch. The assembler ceases printing and, upon 
completion of writing the object module, restarts the printer listing from the beginning. It is suggested that, when 
the stop printing option is used, the printer be taken offline while the printer malfunction or forms alignment 
problem is being corrected. 


7.3.1.2. Repeat Printing Option 


If a second copy of the assembler printer listing is desired, the repeat printing option may be used by setting the 
DATA ENTRY switches to zero (X‘0’) and pressing the OP REQ switch. Upon completion of the first listing, a 
second listing will be produced. 


NOTES: 


1. The foregoing operator requests may be made only after the assembler has begun printing. If made earlier, a 
413F display occurs and the keyin is ignored. 


a 


2 ~~ An operator request with a value greater than X‘OF’ causes a 413F display, or is interpreted as a keyin to the 
operating system or to a symbiont. 


3 The use of either option does not affect assembler production of a relocatable output module. 


7.4, PRINTER OUTPUT 


When a PRINT directive requests a listing of all source code lines, the output listing is: 
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Print Column Data 





1-4 Sequence number of original input line; blank for macro-generated code 








5 Blank 

6-13 Error codes (eight allowable on any one line) 

14 Blank 

15-18 Address : 
19, 20 Blank 

21-36 Object code (maximum of eight bytes or 16 digits printed) 

37—40 Blank 

41—120 Original source code fine 





The printer uses columns 6—13 to list error codes in the assembly listing. The codes used, and their meanings, are 
listed in Table 7—1. 


Table 7—1. Printer Error Codes 





Covering error Rw 
Duplicate label or reference to a duplicate label 

Expression too large, improper syntax, or keyword parameter specified 

in a macro instruction not defined in the proc line of the macro 

definition 


Upper main storage table full in pass 1 of assembler; too many DO statements 
to process in avaitable main storage 


Half-word boundary error 

Instruction error, invalid operation code 
Location counter value too targe 

More DOs than ENDOs 

ORG error, second definition of a label 

PROC error 

Relocation error, terms too many or improper 
Sequence error 

Truncation of oversized term 

Undefined label reference 


Continuation error or ESID table overflow aes 


Assembly input ends with common section or dummy control section 





END card missing 
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7.4.1, Assembler Listing Print Format 


The following are examples of the printer format for the page header and the last line of the assembler listing 


containing the total errors detected. 


Page Header Format 


Print Column 
1—29 


30-37 
38-39 
40-93 
94 
95—98 
99 
100-101 
102 
103—104 
105 
106—107 
108—109 
110-113 
114 
115-117 


118-120 


Data 
TAPE 
UNIVAC 9300 ie \ ASSEMBLY OF 


progname-name in label field of START card 


blank 


title — inserted by TITLE directive 54 characters long 


blank 

DATE 

blank 

characters 1 and 2 of supervisor date 
/ 

characters 3 and 4 of supervisor date 
/ 

characters 5 and 6 of supervisor date 
blank 

PAGE 

blank 

page number 


blank 













































SJ 
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@ Final Line of Assembler Listing 


. Print Column Data ~ 
1-39 same as PAGE HEADER format 
40—49 blank 
50—55 ERRORS 
56 blank 
57-61 error count — grand total of all errors in listing 
62-70 blank 
71-78 REVISION 
79 blank 
80-81 revision number 
82-94 blank 
95-109 same as for PAGE HEADER format 
110-120 blank 
ed 
NOTE: 


The last line of every assembly listing contains total errors (which can be greater in count than the total of all 
the flags because it is only possible to print eight flags per line) and the revision number of the SPERRY 
UNIVAC software. This revision number should be referred to when reporting problems with the software. 


7.5. DISPLAYS FOR DISC ASSEMBLER AND INPUT/OUTPUT 
Displays on the control console associated with the disc assembler are listed in Tables 7—2 and 7-3. 


Table 7-2, Disc Assembler Displays (Part 1 of 2) 


Logical unit x is down. Press START to cancel. 


The source code element on physical unit u does not Press START to cancel. 
exist as specified in PARAM 0000 card, or physical 

unit u does not contain any part of the macro library, 

or source code is to be introduced from the control 

stream, but no source is present. 
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Display 


NOTE: 


Hexadecimal 
Display 



































Hexadecimal 
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Table 7-2, Disc Assembler Displays (Part 2 of 2) 


Reason 


A W or an E was not specified on PARAM 0101. 
A file name was not supplied. 


A logical unit was not supplied or each character of the 
logical unit number was not in the range O—9 or A—F. 


The filename (other than disc source input file or macro 
library) was SYSFILE and was said to be on logical unit 
0. 


More than one file was specified by the same name and 
logical unit number. 


u = physical unit number. 


Table 7—3. Disc Assembler Input/Output Displays 


8410 — unrecoverable abnormal tine indication received from 
dispatcher 

8411/8414 — software error 

8410 — unrecoverable output bus check indication received 
from dispatcher 

8411/8414 — hardware error 

File cannot be opened because the VTOC header cannot 

be located or the file’s format-1 label does not reside 

in area specified by the VTOC. 

No find on search 

8410 — catastrophic failure indication received from dispatcher 


Expiration date does not meet requirements 


8410 — nonoperationa! channel indication received from 
dispatcher 


8410 — Invalid function indication received from dispatcher 
8411/8414 — wrong record length 


File extent limit reached; READ or WRITE attempted that 
references a point beyond physical extent for this file 


File directory filled to capacity 


Final output file described as to be extended (E) but next 
record pointers in format-1 label contain zeros 


File on unit u not a library file; i.e., it does not have 
two ex tents 


8410 — an unload buffer command unsuccessfully issued 









The following stops are due to bad parameter cards. 


Press START to cancel. 


Press START to cancel. 


Press START to cancel. 


Press START to cancel. 


Press START to cancel. 





Key nonzero into 
location 4 to retry, or 
press START to cancel, 


Same as 14u1 


Press START to cancel. 


Same as 14u1 
Same as 14u1 
Press START to cancel. 


Same as 14u1 


Same as 14u1 


Press START to cancel. 


Press START to cancel. 


Key in nonzero to 
location 4 to treat the 
file as a new (W instead 
of E) file, or press 
START to cancel. 


Press START to cancel. 


Same as 14u1 
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7.6. DISPLAYS FOR TAPE INPUT/OUTPUT ROUTINE 











Displays on the control console associated with the tape assembler are listed in Table 7—4. 
Table 7-4. Tape Assembier Input/Output Displays : 
The end block was not found on physical unit Press START to try again. 
u. This display occurs with respect to logical Restart if unsuccessful. 
unit 1 when the assembler cannot find the END record 
on logical unit 1 preparatory to writing out its final 
output (Appendix C). 
The expiration date was not accepted Replace with correct tape and 
on physical unit u. press START to try again, or 
key a nonzero into location 4 
and press START to cancel. 
The end-of-physical-tape (while writing) or a Press START to cancel. 
tape mark (while reading) was detected on physical 
unit u. 
A wrong-length block was read on Press START to cancel. 
physical unit u. 
Physical unit u is in a nonready condition. Correct the problem at physical 
unit u and press START to 7 
continue. ; 
Ned 





The block searched for was not found on physical unit u. Ensure that physical unit 
contains the correct tape. 
Key one of the following 
into location 4 and press 
START: 


0 to try again, 
1 to read forward, 
2 to read backward. 


Restart if unsuccessful. 


The source code element on physical unit u does not exist Press START to cancel. 
as specified in PARAM 0000 card, or physical unit u does 

not contain any part of the macro library, or source code 

is to be introduced from the control stream, but no source 

is present. 





NOTE: 


u= physical unit number 
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8.1. GENERAL 
Whether a program consists of one or more modules, the assembled module or modules must be combined into one 


executable program. This combining process is called linking and is performed by a utility program referred to as the 
linker, 


8.2. LINKER COMMANDS 
Linker command cards may contain information in columns 1 through 77. Logical unit numbers are expressed in 


hexadecimal. Spaces are required in all linker command formats before and after the command’s opcode and 
following the last parameter specified in the operand field. 


8.2.1. PRGM 


The PRGM command instructs the linker to begin construction of a normal, executable program. It provides the 
name to be associated with the program and the address at which the program is to begin in storage. 


The format of this command is: 


OPERAND 





The absolute origin address may be expressed as a number or as an asterisk. In the latter case, the program is assigned 
the same origin as was assigned to the linker doing the linking. “ 
8.2.2. CHAIN 


The CHAIN command instructs the linker to begin the construction of a program which is one of the links in a 
chained job, but is otherwise a normal executable program. 


The format of this command is: 
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8.2.2.1. Fetching 


To get the next chained program, the program’s name must be placed in locations X‘136’ — X‘13D’ by the previous 
program and a FETCH be performed or another / EXEC statement may be given to job control; e.g., 





LABEL AOPERATIONA OPERAND A 
10 6 


ey eg i ag eee 
ON gage pe ey eee Ae Ae ee oe gt el cy 
De ei ae ee a a ep 




















Each link of a chain must begin with a CHAIN command, and the links must be described to the linker in succession. 
The linker allocates to each fink the maximum storage required by any one link and ensures that COMMON is 
assigned the same address in each fink. A maximum of 10 consecutive chained programs is permitted. All programs 
consisting of a common section are given the same address when the chained programs are linked. 





8.2.3. SYMB 


The SYMB command instructs the linker to begin the construction of a symbiont. No overlays are allowed within a 
symbiont. 


The format of the command is: 








In the preceding commands (PRGM, CHAIN, and SYMB), the flags field is a character string. Permissible characters 
in the string are the 26 alphabetics and the multipunch, which, when translated to EBCDIC, yields the EBCDIC byte 
11100001. (In Hollerith card code, this would be an 11-0-9-1 punch.) 


The PRGM, CHAIN, and SYMB commands also produce on the output file an ELT record preceding the module to 
be constructed by the linker. The program or symbiont name becomes the module name (preceded by the nares of 
the groups in which the module is contained). The flags determine the bits of the flag field (columns 6—9) of the 
ELT record in the following format: 


*DHLPSWzZAEIMOTXzBFJNRUYzCGKOxV2Zz 
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where: 
Is always 1. 
Represents the EBCDIC byte 11100001. 


Is always zero. 


Comments, beginning with the first nonblank column after the flags field, from the PRGM, CHAIN, or SYMB 
command are placed in bytes 60—80 of the output ELT record. 


The first command given to the linker must be the PRGM, the CHAIN, or the SYMB command; otherwise the linker 
does not allow further processing and cancels. 


8.2.4. UNITS 





The UNITS command, if present, must follow immediately a PRGM, CHAIN, SYMB, or another UNITS command. 
It instructs the linker to construct a list of logical unit numbers for insertion in the phase record of the program to 
be created. 





The format of this command is: 


A OPERATION A OPERAND 
10 16 





where: 


Each xx is a 2-digit hexadecimal number, the logical unit number of a unit required by the program. 


8.2.5. INCLUDE 


The INCLUDE command instructs the linker to include a specified module or specified portions of a module in the 
current phase. The format of this command is: 


for tape linker: 











for disc linker: 
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If modulename is omitted (marked by a leading comma), the module is in the control stream immediately following 
the INCLUDE command; otherwise, the module is found on the indicated unit or filename. The logical unit number 
is expressed as one or two hexadecimal digits. If the logical unit number is omitted, the same unit is used as for the 
last INCLUDE with the indicated modulename. The initial value is 2 for the tape linker; for the disc tinker, it is the 
logical unit number specified for the input file on the CTL card. For the disc linker, if the filename is omitted, the 
same filename is used as for the last INCLUDE with a module name indicated. The initial filename is the filename 
specified on the CTL card for the input file. If the tape linker is used and the logical unit number is specified, the 
tape is rewound before the search for the module begins. If the logical unit number is not specified, the tape is not 
rewound. 


Modulename may consist of a single name preceded by a slash, in which case the indicated logical unit and/or file is 
read until a module with the specified name is found. This module then will be included; otherwise, the modulename 
must include the name of all the groups within which the element is contained, from outermost to innermost. Thus, 
if module MODLA is group GRP2, which is in group GRP1, the modulename is written as: 


LABEL A coor ar OPERAND A 


SoREh FE REE ENS L,U.#,.¢ [nyaymye,! fips t,) 








If an INCLUDE command specifies an LU#, the tape linker rewinds the specified tape before beginning the search 
for the module. 


The last parameter, if included, is a list of one or more control section names with the list enclosed in parentheses. 
Only the named control sections are included as a result of the INCLUDE command. !f however, a module contains 
a common section, the common section is included when any control section of the module is included. A control 
section may be included in more than one phase. In such a case, all references to that control section are handled as 
follows: 


= ~=If the reference is in a phase in which the control section is included, the reference is linked to the copy of the 
control section in the phase. 


@ If the reference is in a phase in which the control section is not included, the reference is linked to the first 
copy of the control section included in the program. 


= The common section is located immediately above the highest location of any other section coding or job 
control coding. 

8.2.5.1. Sectioning (CSECT, DSECT) 

A label in a CSECT section should be referenced only within its own section; otherwise, an ESID UND error occurs 

when linking that particular section. {f necessary, to reference a label in a section other than the section needed, the 


programmer must include both sections when linking a particular phase to avoid ESID UND errors. 


All ESIDs will be resolved if the following procedure is used: 
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Example (Assembly): 





LABEL AOPERATIONA OPERAND A 
6 


(—) 


fd ! H ri | ! 


be a a bt 


= 


aes Ra eae Se 


s,T 


* 
°o 





= | ot 


5.,,T, A;G 
11° 1 


<< 


. 10 a Hes 
an co | 
aQ x 
“4 4 


< 
iy) 
ES a SA | 


BGN+,7;,,0 


TAGE CON, X%',12,’ : 
Pee pee, tenes 3 

TST | |cjs.€,¢,7 fas 
eee ta Ee | IK 9,9," | cae 
Cera Baa EC ee ee eee oe 
Ie Gece eo ee tee Doe Ree Renee © 


Example (Linker): 








8.2.6. PHASE 


The PHASE command instructs the linker to begin construction of a new phase and indicates how its origin is to be 
determined. 


The format of this command is: 





where: 


phase name 
Represents the name of the phase to be constructed and origin may be one of the following: 


blank 
Indicates the new phase will immediately follow the phase just completed. 
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nnnn 
Is a decimal number or a hexadecimal number of the form X’nnnn‘ and specifies the origin of the phase. 


symbol 
is a previously defined symbol (an entry point of one of the modules already included). The value 
assigned to this symbol is assigned as the origin of the phase. 


symboltn 
ls symbol! and n as defined previously. The value assigned to the symbol is modified as indicated and the 
result assigned as the origin of the phase. 


(phasename list) 
Is a list of one or more phase names separated by commas if more than one name is listed. The list is 
enclosed in parentheses. The phase follows the phase named in the list with whose highest allocated 
address is the greatest. The address allocated is a multiple of two. 


A phase is terminated by the next PRGM, CHAIN, SYMB, PHASE, or END command. The entry point for a phase is 
the address from the first transfer card for a module in the phase. In a phase containing selected control sections of a 
module, the transfer card address is accepted only if its address is external to that module or contained in a control 
section included in the phase. In the absence of a transfer card with an acceptable address, the first address of the 
phase is used as an entry point. The maximum allowable number of phases is 20 to 30, depending upon the number 
of characters in the phase names. 


8.2.7. MOD 


The MOD (modular set) command instructs the linker to set the location counter to the value calculated from the 
operand specifications. 


The format for this command is: 


LABEL OPERATION A OPERAND A 
10 16 





Must be a decimal expression with a value that is the result of 2 raised to a power. 


May be omitted, or it may be a decimal expression. 


The location counter is set to the next number with the value of b, plus a multiple of a which is greater than, or 
equal to, the present value of the location counter. 


Examples: 
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If the present value of the location counter 4024, the value is not modified. If the current value is 4025, it is 
modified to 4032. 


LABEL A bata an OPERAND A 


If the current value of the location counter is 4028, its value is modified to 4035. 


8.2.8. LIBE 


The LIBE command instructs the linker to search for modules externally referenced within the modules being linked 
and not included via INCLUDE statements. The format of this command is: 


for the tape linker: 





The search is limited to modules within the group named on the indicated logical unit or file. If the group to be 
searched is in another group, groupname must so indicate. Thus, if all modules in GRP3 are to be searched and 
GRP3 is in GRP2, which is contained in GRP1, groupname would be written: 

GRP1/GRP2/GRP3 


If LU# is omitted, the search is performed on the logical unit most recently named in a LIBE statement. Initially, 
the search is set to operate on logical unit 0 in group RLOCATBL. 


For the disc linker, if filename is omitted, the filename most recently named in a LIBE statement is used. Initially, 
filename SYSFILE is used. 


If no search is needed, the format is: 


Lit BE OINJE 












8-8 
PAGE 
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A LIBE command is effective for the program in which it appears and all programs until the next LIBE or END card. 
if several LIBE cards appear between two PRGM cards, only the last is effective. Routines included by the automatic 
search feature are included in the first phase of that program. They are not overlaid by any phase of the program 
because they are assigned load addresses beginning immediately after the highest address occupied by any phase of 
the program. 


A module is included automatically only if no flags are associated with it or if all its flags also appear in the PRGM, 
CHAIN, or SYMB command for the program being linked. 

8.2.9. EQU 

The EQU command to the tinker defines values not otherwise supplied in the normal linking process. 


The format of this command is: 


LABEL A OPERATION A OPERAND A 
16 


1 10 
eymbsolls Equi sere [esiestiele 


where: 


symbol 
Represents the name of the symbol, the value by which it is to be defined. 


expression 
Is any sum or difference of decimal values, hexadecimal values of the form X’nnnn’, and previously 
defined symbols. A previously defined symbol is one that is an entry point of a module previously 
named on an INCLUDE card, or a symbol already defined by an EQU card. 


8.2.10. END 
The END card (/* in columns 1 and 2) terminates the linker operation. To rewind logical unit 1 at the end of the 


tape linking, place a nonblank in column 11 of the card. 


8.2.11. SELECT 


The SELECT command causes the linker to copy a module from an input file (or tape) to the final output file (or 
tape). 


The format of this command is: 


for the tape linker: 
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for the disc linker: 


LABEL OPERATION A OPERAND A 
10 16 


A 
p-seniete fete bans LIU,# f,iflpeyn,aymle 


where: 

modulename 
Is the modulename or the groupname and modulename in the input ELT record of the module to be 
selected. The module may be source, relocatable, or object code. It must begin with an ELT record and 
be followed by a BOG, EOG, ELT, or END record. 

LU# 
ts the logical unit number of the tape or disc containing the input module to be selected. 

filename 


Is the name of the file containing the input module to be selected. 


If no logical unit number is specified, the last logical unit number specified in a SELECT or INCLUDE command is 
used; if no previous logical unit number (and filename, for disc) was specified previously in a SELECT or INCLUDE 
command, the search is made on the initial logical unit number/filename. The initial logical unit number for the tape 
linker is 2; for the disc linker the initial logical unit number and filename are specified in the CTL card. The search 
for the named module begins in a forward direction from the current position, if tape. 





If a logical unit number or filename is specified in a SELECT command, that designation remains selected until 
changed by a subsequent SELECT or INCLUDE command. The tape linker rewinds the tape on the specified logical : : 
unit before beginning the search for the named module. : 





The SELECT command should be placed after the last INCLUDE command of a program or symbiont or after the 
last INCLUDE command of the last program of a chain of programs. SELECT terminates a chain, but another chain 
may follow. 


When the linker detects a SELECT command, it treats the command as an indication that all commands for a 
program, a symbiont, or a chain of programs under construction have been submitted. After completion of the 


program construction, the linker locates the named module on the specified logical unit and copies the module on 
the output file. The copied module is preceded by an ELT record on the output file. 


8.2.12. HALT 
The HALT command permits the operator to take appropriate action during a link; e.g., changing input disc packs. 


The format of this command is: 
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where: 





nnnn 
ls any allowable hexadecimal character, 0 through F. The value is right-justified in the light display; that 
is, HALT 1 appears as 0001. 


8.2.13. SPACE 


The SPACE command controls the spacing of the listing by specifying SPACE 1 or SPACE 2. If an error is made in 
the number of spaces designated, the default of 1 space occurs. 


This option is not available in the tape linker, which always produces a single-spaced listing. 


The format of this command is: 


LABEL A eee a OPERAND A 


where: 


ts the number 1 or the number 2. 


8.3. LINKER OPERATING INFORMATION 
The procedures and displays used to operate the linker, the error messages produced on the printer, and an 
illustration of a sample deck are described in the following paragraphs. 
8.3.1. Disc Linker Procedures 
To execute the disc linker, the following control stream must be submitted: 
/ EXEC DL11 (DLOO for 8410 linker) 


/ DATA Cc 
CTL (See 8.3.1.1 for parameters) 


linker commands 


* 


Disc packs containing files required by the linker must be mounted before executing the linker. 
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NOTES: 


1. If using 8410 disc drives, remove the file protect from disc on logical unit number O as DLOO uses the 
Fastband for scratch space. 


2 ___ ‘File protect on logical unit number 0 is allowed on the 8411/8414 disc subsystem unless the scratch or final 
output file is located on unit 0. 


3. Do not change output discs during linking on the 8411/8414 disc subsystems. With a careful choice of areas it 
is possible to change input disc packs as many times as required by use of the HALT command and pack 
substitution. 





8.3.1.1. CTL Card 


Only one CTL card may be specified for the disc tinker. The CTL card is mandatory and must follow the / DATA C 
card in the control stream. 


The format of the card is: 






AOPERATIONA OPERAND 
10 16 





qt ie 
, 
RNS QES i EX, Mamie, Re, xX), Mamie, Si, xx, Mamie. 

















where 
Cc 
Output is to use check write. 
N 
Output is to use normal write, or unit is 8411/8414 disc drive. 
Ww 
Indicates final output file; output to start with beginning of file. 
E 
Indicates final output file; output to be written as an extension of the information already in the file. 
R { 
Indicates first input file. 
S 
Indicates scratch file; this must be a library type file though the directory need only hold one record. 
XX 
Is a logical unit number; one or two hexadecimal digits. é 
name 


Indicates filename. 


No default option is permitted. Absolute control over the location of the linker output module is imperative. The 
control card is printed. Each file description must state all three designators; i.e., type of file, unit, and filename. All 
files used by the linker must be in library format; i.e., one directory extent and one data extent. 
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8.3.2. Tape Linker Procedures 
To execute the tape linker, the following control stream must be sumitted: 


/ EXEC TLOO 
/DATAC 


. (linker commands) 
- 
Appropriate tapes, as required by the linker, including the output tape on logical unit 1 and the scratch tape on 
logical unit 3, must be mounted before executing the linker. 
8.4. PRINTER ERROR MESSAGES 


The linker routine notifies the programmer of problem program errors. The messages that can be made by printer 
listing during a linker run are listed in Table 8—1. 


The revision number of the SPERRY UNIVAC software is printed on the last line of output. The revision number 
must be referenced when reporting software problems. 

8.4.1, User Program Sense Indicator (UPSI) Byte Setting 

If an error is detected, during a link, the single bit of the UPSI byte (location X‘117’), shown as a 1 (00001000), is 
set to 1. This permits detection of errors by a subsequent program in the job stream or by a / SKIP job control card, 


providing a / JOB control stream command does not intervene. The linker never resets this bit to zero; therefore, any 
error in a series of links may be tested for after the last link. 


8.4.2. Total Error Count 


A total error count is printed in the last line of the linker listing. 


8.4.3. Suppression of Second Pass Printing 


To cause the suppression of all printer output during the second pass of the linker (except page heading, error 
messages, and the total error count), place the following parameter card after the / EXEC card and in front of the / 
DATA card. : 


OPERAND 










8-13 
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Table 8—1. Linker Printed Error Messages 





NAME UND Name is undefined. | 
4 
PH NM UN Phase name is undefined. 4 
; 
HEX NG Hexadecimal value is not good. 


ESID UND Undefined ES!D appears in relocatability data (RLD) on transfer card or 
text card. 


NAME BLK Name is blank. a 
OVERFLOW Overflow of table area (any table). 

SYMB NA Symbiont is not allowed. : 
COMMA NA Comma is not allowed. : 
EXPRESHN Expression is in error. 
OPRND NG Operand is not good. 


)MISSING Right parenthesis is missing. 





BAD UNIT Physical unit is not allocated; logical unit is 1, 3, or greater than 7 for “al 
the tape linker, or is not in the system configuration. | 


HOLE CNT The sum of the bytes from columns 8—72 of an input record did not agree with 
the checksum in column 7. 


ABS MODL Absolute module is not allowed. | | 
ALR INCL Module already is included. 
CARDCNT Card count error is in module. 3 
UNEQU Unequal value is on defined name. 
COL 1? Column 1 error is on EQU, 

NO GROUP Group specified on LIBE card is not in this file. 4 


NO ELT ELT record specified on INCLUDE card is not in the file. 





8.5. DISPLAYS FOR DISC LINKER - 
The displays for the disc linker routine are listed in Table 8—2. 4 


Displays 14u1 through 14uF for the disc tinker are the same as displays 14u1 through 14uF, as shown in Table 7—3. 1 
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Table 8-2, Disc Linker Displays 


Hexadecimal ; 
Display 


| ros Wrong input image was read Press START to ignore the image. 


Card out of sequence Press START to ignore the card. 
1FFF 


If the display occurs while reading an object 


module from the control stream, the card on 
8.6. DISPLAYS FOR TAPE LINKER 
































Card hole count error 





which the error occurred is the second card 
from the top in the output stacker. 


To reread the error card, place it and all 
following cards (including the card in the wait 
station) in the input hopper, feed a card, and 
press START. 





lf the display occurs while reading a tape or 
disc object module, pressing START may result 
in the generation of an invalid object module 

by the linker. 





Unrecoverable condition of missing or Press START to cancel. 
invalid phase name, invalid device, 
overflow message, or a PRGM, CHAIN, 

or PHASE command card is preceded by a 
command card which is not in proper 


sequence. 











The first card read was a CTL card 
containing invalid specifications, 
or was not a CTL card. 


Reinitialize the linker input deck with a valid 
CTL card as the first card in the reader, feed 
a card, and press START. 





The displays for the tape linker are listed in Table 8—3. Displays 20u0 through 20uE for the tape linker are the same 
as displays 20u0 through 20uE as shown in Table 7—4. 


Table 8—3. Tape Linker Displays 


Cannot read from logical unit 3 to load Press START to cancel. 


eo | Cannot read from logical unit 1 to load Press START to cancel. 


pass 2. 
a 
eS 


Unrecoverable condition of missing or Press START to cancel. 
invalid phase name, invalid device, 

overflow message, or a preceding 1555 

display. 
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Appendix A. Tape Language 
Processor Conventions 


Certain processor conventions are used consistently by the language processors such as the assembler, the linker, the 
FORTRAN compiler, and the COBOL compiler. The following describe these conventions. 


Each processor produces its output on logical unit 1. The system is assumed to be on logical unit 0. Each processor, 
at the beginning of its operation, must test to see if the tape on logical unit 1 is at load point. If the tape is not at 
load point, no action is taken. If it is, the processor must read past any volume headers. The processor must then 
check the HDR1 record expiration date against the date stored in the supervisor. If the HDR1 date is less than or 
equal to the date stored in the supervisor, or if there is no HDR 1 label, the processor rewinds the tape. 





A processor using logical unit 1 as a scratch must record an END record indicating block number 1 and zero group 
levels if that tape is at load point. Following this, a tape mark is recorded on tape. If the tape is not at load point, it 
is assumed that it is positioned immediately past the tape mark that follows an END record. This tape then may be 
used by the processor for scratch. When the processor is ready to write its output, it must back space past the tape 
mark. It must then read the END record backward to pick up the block count and group names it will use in 
producing its output. It then overwrites the END record in producing its first block of output with the block 
number that had been in the end record. 


If a processor does not use logical unit 1 for scratch, it may postpone its load point test until it is ready to write its 
output. In this case, it would not need to write the END record and tape mark, and immediately backspace and 
overwrite them. 


When a processor that has found logical unit 1 at load point is ready to write on logical unit 1, it must first read past 
any volume headers then write an HDR1 label with an expiration date of zeros before producing any output of its 
own. 





When the processor finishes producing its output, it writes an appropriate END record and tape mark on logical unit 2 
1 following the output. The tape is not rewound. : 


If a scratch tape is at load point, a processor reads past any volume headers. It checks the HDR1 record expiration 
date against the date stored in the supervisor. If the HDR1 date is larger, it rewinds the tape with interlock and gives 
a standard error display. It tries again if START is pressed. If the HDR1 date is less than or equal to the date stored 
in the supervisor, it writes a tape mark and the remainder of tape is available for scratch. If there is no HDR1 label, it 
writes one with an expiration date of zeros, followed by a tape mark. The rest of the tape is then available. 
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Appendix B. Standard Card, EBCDIC, 
and Printer Graphic Codes 


SPERRY UNIVAC 9200/9300 Series software is designed to use the standard card, internal, and printer graphic 
codes as shown in Table B—1. These codes are based on a byte divided into a zone and digit portion, each containing 
four bits, as: 


zone digit 


one [sr [oe 


In Table B—1, the zone and digit bits of the byte are the matrices; for each position the Hollerith code and the 
printer graphic, if any, are given. 





Table B—1, Standard Codes (Part 1 of 4) 


(Two Most Significant Bits of Zone 00) 


a ee ee ee 
12-0-9-8-1 12-11-9-8-1 -0-9-8- 12-11-0-9-8-1 
12-9-1 11-9-1 91 
12-9-2 1-9-2 . 9-2 
12-9-3 11-9-3 93 
12-9-4 11-9-4 94 
12-9-5 11-9-5 : 95 


12-9-6 11-96 9-6 





12-9-7 11-9-7 - 97 


12-9-8 11-9-8 ° 98 


12-9-8-1 11-9-8-1 


12-9-8-2 11-9-8-2 


12-9-8-3 11-9-8-3 


12-9-8-4 11-9-8-4 


12-9-8-5 11-9-8-5 


12-9-8-6 11-9-8-6 


12-9-8-7 11-9-8-7 
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Table B—1, Standard Codes (Part 2 of 4) 


(Two Most Significant Bits of Zone 01) 


Two Least Significant Bits of Zone 


12-11-9-1 12-11-0-9-1 


12-11-9-2 11-0-9-2 12-11-0-9-2 
12-11-9-3 11-0-9-3 12-11-0-9-3 
12-11-9-4 11-0-9-4 12-11-0-9-4 
12-11-9-5 11-0-9-5 12-11-0-9-5 
12-11-9-6 11-0-9-6 12-11-0-9-6 
12-11-9-7 11-0-9-7 12-11-0-9-7 
12-11-9-8 11-0-9-8 12-11-0-9-8 
11-8-1 0-8-1 8-1 


11-8-2 12-11 
! 


11-8-3 0-8-3 
$ 


11-8-4 
* 


11-8-5 
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12-0-8-1 


12-0-1 


12-0-2 


12-0-3 


12-0-4 


12-0-5 


12-0-6 


12-0-7 


12-0-8 


12-0-9 


12-0-8-2 


12-0-8-3 


12-0-8-4 


12-0-8-5 


12-0-8-6 


12-0-8-7 


12-11-8-1 


12-11-1 


12-11-2 


12-11-3 


12-11-4 


12-11-5 


12-11-6 


12-11-7 


12-11-8 


12-11-9 


12-11-8-2 


12-11-8-3 


12-11-84 


12-11-8-5 


12-11-8-6 


12-11-8-7 
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Table B—1. Standard Codes (Part 3 of 4) 


(Two Most Significant Bits of Zone 10) 


Two Least Significant Bits of Zone 


11-0-2 


11-0-3 


11-0-4 


11-0-5 


11-0-6 


11-0-7 


11-0-8 


11-0-9 


11-0-8-2 


11-0-8-3 


11-0-8-4 


11-0-8-5 


11-0-8-6 


11-0-8-7 





12-11-0-8-1 


12-11-0-1 


12-11-0-2 


12-11-0-3 


12-11-04 


12-11-0-5 


12-11-0-6 


12-11-0-7 


12-11-0-8 


12-11-0-9 


12-11-0-8-2 


12-11-0-8-3 


12-11-0-8-4 


12-11-0-8-5 


12-11-0-8-6 


12-11-0-8-7 
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Table 8B—1, Standard Codes (Part 4 of 4) 


(Two Most Significant Bits of Zone 11) 


Two Least Significant Bits of Zone 


12-8 
H 


12-9 11-9 0-9 
! R Zz 9 


12-0-9-8-2 12-11-9-8-2 11-0-9-8-2 12-1 1-0-9-8-2 
12-0-9-8-3 12-11-9-8-3 11-0-9-8-3 12-11-0-9-8-3 
12-0-9-8-4 12-11-9-8-4 11-0-9-8-4 12-11-0-9-8-4 
12-0-9-8-5 12-11-9-8-5 11-0-9-8-5 12-11-0-9-8-5 


12-0-9-8-6 12-11-9-8-6 11-0-9-8-6 12-11-0-9-8-6 


12-0-9-8-7 12-11-9-8-7 11-0-9-8-7 12-11-0-9-8-7 
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